api.automapa.comv3 - tous les systèmes sont opérationnels
v3 - 23 méthodes - 8 services

AutoMapa REST API

Géocodage, itinéraires, matrices de distance, limitations de vitesse et données routières dans une API HTTP/JSON. Chaque appel utilise POST /v3/<Service>/<method>.

Geocoder.geocodesession requise
POST/v3/Geocoder/geocode
address.countryPL
address.cityWarszawa
address.streetDomaniewska
Exemple de réponse200 OK
Démarrage rapide

Trois appels pour votre premier résultat de géocodage.

Commencez avec Session.getSalt, ouvrez une session courte avec Session.generateSession, puis envoyez Session-Id dans les appels protégés.

# Bash + PHP CLI (7.4+). Fournir AUTOMAPA_KEY depuis l’intégration serveur ; après l’étape 1, calculer AUTOMAPA_PASS_HASH selon le guide, puis après l’étape 2 définir AUTOMAPA_SESSION depuis result.sessionId. Ne pas stocker ces valeurs dans le code ou les journaux.
# 1) Obtenir un salt pour votre clé
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) Ouvrir une 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) Effectuer un appel protégé
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 } }'
Ressources d’intégration

Choisissez les outils adaptés à votre workflow

Explorez l’API avec Swagger UI et Scalar ou importez la collection Postman.

OpenAPIDisponible

Swagger UI

Parcourez le contrat OpenAPI actuel dans une interface Swagger UI publique en lecture seule.

Ouvrir Swagger UI
OpenAPIDisponible

Scalar

Une référence Scalar moderne pour parcourir les schémas, méthodes et exemples de requêtes.

Ouvrir la référence Scalar
CollectionDisponible

Postman Collection

Une collection importable avec variables sûres, authentification et requêtes prêtes à exécuter.

Télécharger la collection Postman
CodeDisponible

Exemples de code

Exemples SDK natifs et migration depuis Google Geocoding en PHP et Python.

Ouvrir les exemples de code
GitHubDisponible

Dépôt GitHub

Parcourez les dépôts AutoMapa, les exemples maintenus et les ressources d’intégration sur GitHub.

Ouvrir GitHub
Services

Session 2 méthodes

Authentification. Méthodes pour obtenir un identifiant de session requis par les appels protégés.

PingPong 1 méthode

Vérification de connectivité.