api.automapa.comv3 - wszystkie systemy działają
v3 - 23 metody - 8 usług

AutoMapa REST API

Geokodowanie, trasy, macierze odległości, limity prędkości i dane drogowe w jednym API HTTP/JSON. Każde wywołanie używa POST /v3/<Service>/<method>.

Geocoder.geocodewymagana sesja
POST/v3/Geocoder/geocode
address.countryPL
address.cityWarszawa
address.streetDomaniewska
Przykładowa odpowiedź200 OK
Szybki start

Trzy wywołania do pierwszego wyniku geokodowania.

Zacznij od Session.getSalt, otwórz krótką sesję przez Session.generateSession, a potem przekazuj Session-Id w chronionych wywołaniach API.

# Bash + PHP CLI (7.4+). Dostarcz AUTOMAPA_KEY z integracji serwerowej; po kroku 1 oblicz AUTOMAPA_PASS_HASH według przewodnika, a po kroku 2 ustaw AUTOMAPA_SESSION z result.sessionId. Nie zapisuj tych wartości w kodzie ani logach.
# 1) Pobierz salt dla klucza
php -r 'echo json_encode(["key" => $argv[1]], JSON_THROW_ON_ERROR);' -- "$AUTOMAPA_KEY" | \
curl -X POST https://api.automapa.com/v3/Session/getSalt \
  -H "Content-Type: application/json" \
  --data-binary @-

# 2) Otwórz sesję: MD5(MD5(password) + salt)
php -r 'echo json_encode(["key" => $argv[1], "pass" => $argv[2]], JSON_THROW_ON_ERROR);' -- "$AUTOMAPA_KEY" "$AUTOMAPA_PASS_HASH" | \
curl -X POST https://api.automapa.com/v3/Session/generateSession \
  -H "Content-Type: application/json" \
  --data-binary @-

# 3) Wykonaj chronione wywołanie
curl -X POST https://api.automapa.com/v3/Geocoder/geocode \
  -H "Content-Type: application/json" \
  -H "Session-Id: $AUTOMAPA_SESSION" \
  -d '{ "address": { "country": "PL", "city": "Warszawa", "street": "Domaniewska", "house": "37", "maxResult": 1 } }'
Materiały integracyjne

Wybierz narzędzia pasujące do Twojego procesu

Poznaj API w Swagger UI i Scalar lub zaimportuj kolekcję Postman.

OpenAPIDostępne

Swagger UI

Przeglądaj aktualny kontrakt OpenAPI w publicznym Swagger UI działającym w trybie tylko do odczytu.

Otwórz Swagger UI
OpenAPIDostępne

Scalar

Nowoczesny widok referencji Scalar do przeglądania schematów, metod i przykładów zapytań.

Otwórz dokumentację Scalar
CollectionDostępne

Postman Collection

Kolekcja do importu z bezpiecznymi zmiennymi, uwierzytelnianiem i gotowymi zapytaniami.

Pobierz kolekcję Postman
CodeDostępne

Przykłady kodu

Natywne przykłady SDK oraz migracja z Google Geocoding w PHP i Pythonie.

Otwórz przykłady kodu
GitHubDostępne

Repozytorium GitHub

Przeglądaj repozytoria AutoMapa, utrzymywane przykłady i materiały integracyjne w serwisie GitHub.

Otwórz GitHub
Usługi

Session 2 metody

Uwierzytelnianie. Metody potrzebne do uzyskania identyfikatora sesji dla chronionych wywołań.

PingPong 1 metoda

Sprawdzenie łączności.