Google Maps Platform est l'un des services de géocodage les plus intégrés qui soient, ce qui en fait aussi l'un des plus difficiles à quitter. Réécrire les constructeurs de requêtes et les analyseurs de réponses dans tout un code source, simplement pour essayer un autre fournisseur, vaut rarement le temps d'ingénierie que cela coûte. Nous avons donc construit un hôte qui ne vous demande de rien réécrire.
Notre hôte compatible Google Maps Platform reproduit à l'identique les paramètres de requête et la structure de réponse du service d'origine, à l'exception des textes de copyright, de conditions et de confidentialité, qui sont les nôtres. Tout ce que votre intégration envoie actuellement aux endpoints de géocodage de Google, elle peut l'envoyer aux nôtres à la place. Changer de fournisseur revient à changer un nom d'hôte et une clé, et non à lancer un projet de développement.
Cet hôte coexiste avec nos propres endpoints natifs. Si vous partez de zéro, /v1/forward, /v1/reverse, /v1/autocomplete et /v1/postcode sont documentés sur /docs/ et vous donnent directement notre format de requête. Si vous avez déjà du code écrit pour le format de Google, l'hôte compatible sur /compatibility/google-maps/ vous permet de le conserver tel quel.
L'authentification fonctionne avec la même souplesse que sur tout My Geocode : envoyez votre clé en en-tête X-API-Key, en en-tête Authorization: Bearer, en authentification HTTP Basic avec la clé comme nom d'utilisateur, ou en paramètre de requête. Quelle que soit la méthode qu'utilise déjà votre bibliothèque cliente pour l'API de Google, l'une de ces quatre lui correspondra, si bien que le code d'authentification de votre intégration a lui aussi rarement besoin de changer.
Les tarifs de l'hôte compatible sont les mêmes que partout ailleurs sur My Geocode. Chaque clé bénéficie de 2 500 requêtes gratuites par jour, en plus des 2 500 par jour disponibles depuis n'importe quelle adresse sans aucune clé, comptées par réseau. Au-delà, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre tout pour 50 € par mois. Il n'existe pas de tarif distinct et plus élevé pour l'utilisation d'un hôte compatible plutôt que d'un endpoint natif. Chaque endpoint et chaque hôte drop-in coûte le même prix.
Chaque réponse comporte aussi les mêmes en-têtes de quota que le reste de l'API, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining et les autres, ce qui vous donne sur votre utilisation une visibilité qu'un simple changement de fournisseur ne vous offrirait pas gratuitement.
Si votre intégration a besoin de plus que la réponse standard, ajouter mg_extras=1 à une requête, ou l'en-tête X-MG-Extras, ajoute des champs supplémentaires facultatifs, comme l'altitude du sol, à la structure compatible. C'est entièrement additif : sans cette option, la réponse correspond précisément au format du fournisseur d'origine.
Faire l'essai prend quelques minutes, pas un sprint. Dirigez un appel de test vers /compatibility/google-maps/ avec une nouvelle clé, et comparez la réponse à celle que vous obtenez déjà aujourd'hui.