api.automapa.comv3 - all systems normal
v3 - 23 methods - 8 services

AutoMapa REST API

Geocoding, route planning, distance matrices, speed limits and road intelligence in one HTTP/JSON API. Every call uses POST /v3/<Service>/<method>.

Geocoder.geocodesession required
POST/v3/Geocoder/geocode
address.countryPL
address.cityWarszawa
address.streetDomaniewska
Example response200 OK
Quickstart

Three calls to your first geocoding result.

Start 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 } }'
Integration resources

Choose the tooling that fits your workflow

Explore the API with Swagger UI, Scalar and an importable Postman collection.

OpenAPIAvailable

Swagger UI

Browse the current OpenAPI contract in a public, read-only Swagger UI.

Open Swagger UI
OpenAPIAvailable

Scalar

A modern Scalar reference view for browsing schemas, methods and request examples.

Open Scalar reference
CollectionAvailable

Postman Collection

An importable collection with safe variables, authentication flow and ready-to-run requests.

Download Postman Collection
CodeAvailable

Code examples

Native SDK examples and migration from Google Geocoding, in PHP and Python.

Open code examples
GitHubAvailable

GitHub repository

Browse AutoMapa repositories, maintained examples and integration resources on GitHub.

Open GitHub
Services

Session 2 methods

Authentication. Methods needed to obtain a session id required to call protected methods.

PingPong 1 method

Connectivity check.

RoadPermit 4 methods

CRUD over per-region road-permit documents stored in MongoDB.