Swagger UI
Browse the current OpenAPI contract in a public, read-only Swagger UI.
Open Swagger UIGeocoding, route planning, distance matrices, speed limits and road intelligence in one HTTP/JSON API. Every call uses POST /v3/<Service>/<method>.
/v3/Geocoder/geocodeStart with Session.getSalt, open a short-lived session with Session.generateSession, then pass Session-Id on protected API calls.
# Bash + PHP CLI (7.4+). Supply AUTOMAPA_KEY from your server integration; after step 1 compute AUTOMAPA_PASS_HASH using the guide, and after step 2 set AUTOMAPA_SESSION from result.sessionId. Keep these values out of code and logs.
# 1) Get a salt for your key
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) Open a session: 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) Make a protected call
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 } }'
Explore the API with Swagger UI, Scalar and an importable Postman collection.
Browse the current OpenAPI contract in a public, read-only Swagger UI.
Open Swagger UIA modern Scalar reference view for browsing schemas, methods and request examples.
Open Scalar referenceAn importable collection with safe variables, authentication flow and ready-to-run requests.
Download Postman CollectionNative SDK examples and migration from Google Geocoding, in PHP and Python.
Open code examplesBrowse AutoMapa repositories, maintained examples and integration resources on GitHub.
Open GitHubAuthentication. Methods needed to obtain a session id required to call protected methods.
Connectivity check.
Forward and reverse geocoding.
Address and POI suggestions.
Route search, distance matrix and stop-order optimization.
Information about road segments and speed limits.
CRUD over per-region road-permit documents stored in MongoDB.
Speed-violation analysis for recorded GPS tracks.