Les API
Huit endpoints sous https://api.mygeocode.com/v1/. Chacun accepte des paramètres de requête dans une requête GET et renvoie du JSON. Ils partagent un même quota, un même ensemble de codes d'erreur et un même prix.
API de géocodage direct
GET /v1/forwardEnvoyez une adresse, un nom de lieu ou une description approximative et obtenez des coordonnées, une adresse normalisée et chacun de ses éléments.
Détails et exemplesAPI de géocodage inverse
GET /v1/reverseEnvoyez une latitude et une longitude et obtenez l'adresse la plus proche, avec la ville, la région, le code postal et le pays détaillés.
Détails et exemplesAPI de saisie semi-automatique d'adresses
GET /v1/autocompleteSuggérez des adresses pendant la saisie. Chaque suggestion est accompagnée de coordonnées, vous avez donc rarement besoin d'un second appel.
Détails et exemplesAPI de recherche IPv4
GET /v1/ipv4Pays, région, ville, coordonnées, fuseau horaire et propriétaire du réseau pour toute adresse IPv4, ou pour l'appelant si vous l'omettez.
Détails et exemplesAPI de recherche IPv6
GET /v1/ipv6Les mêmes informations pour les adresses IPv6, plus le préfixe annoncé auquel appartient l'adresse.
Détails et exemplesAPI de fuseau horaire
GET /v1/timezoneNom du fuseau horaire IANA, décalage UTC, statut de l'heure d'été et heure locale pour toute coordonnée, maintenant ou à l'horodatage de votre choix.
Détails et exemplesAPI d'altitude
GET /v1/elevationAltitude au-dessus du niveau de la mer en mètres pour un point, ou jusqu'à 100 points en un seul appel.
Détails et exemplesAPI de code postal
GET /v1/postcodeConvertissez un code postal en nom de lieu, région et coordonnées. Fonctionne avec les ZIP codes, les postcodes et leurs équivalents dans la plupart des pays.
Détails et exemplesCe qu'elles ont en commun
Même enveloppe
Chaque réponse comporte au premier niveau un status valant ok ou error. Les erreurs contiennent un code lisible par une machine et une phrase que vous pouvez journaliser. Les coordonnées sont toujours en degrés décimaux dans lat et lon.
Mêmes règles partout
Toute adresse dispose de 2 500 requêtes gratuites par jour sans clé. Chaque clé dispose de ses propres 2 500 requêtes gratuites par jour (partagées avec les requêtes sans clé provenant du même réseau), puis du crédit prépayé ou d'un forfait Unlimited. Une clé en paiement à l'usage sert deux adresses IP par période glissante de 24 heures, une clé Unlimited trois. Voir authentification.
Même prix
Un géocodage inverse coûte le même prix qu'une recherche d'IP : rien pour les 2 500 premières requêtes par jour sur chaque clé, puis 0,0001 € chacune en crédit prépayé, ou 50 € par mois pour une clé Unlimited. Voir tarifs.
Ce qui compte comme une requête
Presque tout se résume à un appel, une requête. Les exceptions sont les appels groupés, où chaque élément du lot compte séparément.
| Endpoint | Compte comme |
|---|---|
| Géocodage direct, géocodage inverse, recherche de code postal | 1 requête par appel, quel que soit le nombre de résultats renvoyés |
| Saisie semi-automatique d'adresses | 1 requête par appel. Appliquez un anti-rebond aux frappes dans votre client ; les SDK le feront pour vous |
| Recherche IPv4 et IPv6 | 1 requête par appel, ou 1 par adresse dans un lot |
| Recherche de fuseau horaire | 1 requête par appel |
| Recherche d'altitude | 1 requête par point. Un appel avec 20 points compte pour 20 |
| Hôtes compatibles (Google, Bing, HERE et autres) | Mêmes règles que l'endpoint sur lequel ils reposent |
| Remplacements JavaScript : chargements de carte et tuiles | 0. Seuls les appels de géocodage, de saisie semi-automatique et d'altitude comptent |
Pas encore disponible
Le calcul d'itinéraires, les matrices de distances et les isochrones ne font pas partie du service et ne sont pas prévus cette année. La recherche de points d'intérêt par catégorie est à l'étude. Si vous avez besoin de l'une de ces fonctions pour changer de fournisseur, dites-le-nous ; cela nous aide à décider de la suite.