Référence API
L'API geocodeme.net est disponible à l'adresse https://api.geocodeme.net/v1. Tous les endpoints sont versionnés sous le préfixe /v1. Les changements incompatibles avec le comportement documenté ici seront introduits sous un nouveau préfixe de version (par ex. /v2). Un correctif qui remet un endpoint en accord avec cette documentation n'en fait pas partie ; il est livré sur /v1 et annoncé dans le changelog.
Toutes les requêtes nécessitent une clé API. Passez-la via le header X-Api-Key ou le paramètre de requête api_key. Consultez Authentification pour plus de détails.
Endpoints
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /v1/geocode | Géocodage direct : convertir une adresse en coordonnées GPS |
| GET | /v1/reverse | Géocodage inverse : convertir des coordonnées GPS en adresse |
| POST | /v1/match | Map matching : recaler une trace GPS sur le réseau routier |
| GET | /v1/nearest | Snap-to-road : trouver le segment de route le plus proche d'une coordonnée |
| GET | /v1/autocomplete | Recherche à la frappe (1 crédit) |
| GET | /v1/route | Itinéraire point à point avec instructions (2 crédits) |
| GET | /v1/isochrone | Polygones d'accessibilité : « qu'est-ce que j'atteins en N minutes ? » (10 crédits, Startup+) |
| POST | /v1/matrix | Matrices de temps/distances jusqu'à 100×100 (Startup+) |
| GET | /v1/elevation | Altimétrie et profils de terrain (2 crédits, Startup+) |
| POST | /v1/batch/geocode | Géocodage par lot asynchrone jusqu'à 10 000 adresses (Growth+) |
Liens rapides
- Authentification : formats de clé API et méthodes d'authentification
- Crédits & quotas : poids en crédits par endpoint et capacités par plan
- Limitation de débit : limites de débit par seconde et quotas de crédits par plan
- Codes d'erreur : référence complète des erreurs avec codes de statut HTTP et exemples
Essayez en direct
Aucune clé API requise pour commencer : le Playground embarque une clé de démonstration publique à débit limité (10 requêtes par minute). Cette clé est volontairement côté client et ne peut pas être utilisée pour des charges de production. Pour des limites plus élevées, saisissez votre propre clé API dans le Playground.
Ouvrir le Playground interactif →
Tous les endpoints renvoient par défaut des réponses au format JSON. Les endpoints /v1/geocode et /v1/reverse prennent en charge un paramètre format=geojson pour une sortie GeoJSON. Les endpoints /v1/match et /v1/nearest ne prennent pas en charge le paramètre format.
La spécification OpenAPI des endpoints publics est disponible à l'adresse /openapi.json ; importez-la dans Postman, Insomnia ou votre générateur de code préféré.