api.automapa.comv3 - усі системи працюють
v3 - 23 методи - 8 сервісів

AutoMapa REST API

Геокодування, маршрути, матриці відстаней, обмеження швидкості та дорожні дані в одному HTTP/JSON API. Кожен виклик використовує POST /v3/<Service>/<method>.

Geocoder.geocodeпотрібна сесія
POST/v3/Geocoder/geocode
address.countryPL
address.cityWarszawa
address.streetDomaniewska
Приклад відповіді200 OK
Швидкий старт

Три виклики до першого результату геокодування.

Почніть з Session.getSalt, відкрийте коротку сесію через Session.generateSession, а потім передавайте Session-Id у захищених викликах.

# Bash + PHP CLI (7.4+). Надайте AUTOMAPA_KEY із серверної інтеграції; після кроку 1 обчисліть AUTOMAPA_PASS_HASH за посібником, а після кроку 2 задайте AUTOMAPA_SESSION із result.sessionId. Не зберігайте ці значення в коді чи журналах.
# 1) Отримати salt для ключа
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) Відкрити сесію: 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) Виконати захищений виклик
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 } }'
Матеріали для інтеграції

Оберіть інструменти для свого процесу

Ознайомтеся з API через Swagger UI і Scalar або імпортуйте колекцію Postman.

OpenAPIДоступно

Swagger UI

Переглядайте актуальний контракт OpenAPI у публічному Swagger UI в режимі лише для читання.

Відкрити Swagger UI
OpenAPIДоступно

Scalar

Сучасний довідник Scalar для перегляду схем, методів і прикладів запитів.

Відкрити довідник Scalar
CollectionДоступно

Postman Collection

Колекція для імпорту з безпечними змінними, автентифікацією та готовими запитами.

Завантажити колекцію Postman
GitHubДоступно

Репозиторій GitHub

Переглядайте репозиторії AutoMapa, підтримувані приклади та інтеграційні матеріали на GitHub.

Відкрити GitHub
Сервіси

Session 2 методи

Автентифікація. Методи для отримання session id, потрібного для захищених викликів.

PingPong 1 метод

Перевірка з’єднання.

RoadPermit 4 методи

CRUD документів дорожніх дозволів по регіонах.

Speed 2 методи

Аналіз перевищень швидкості для записаних GPS-треків.