Geoapify associe le géocodage à un ensemble plus large d'outils de localisation, si bien que les intégrations construites autour de ce service touchent parfois une plus grande partie du code qu'un simple appel d'API ne le laisserait penser. Notre hôte compatible se concentre strictement sur la structure des requêtes et réponses de géocodage, reproduite à l'identique, afin que cette partie puisse migrer sans perturber tout ce qui l'entoure.
L'hôte reproduit précisément les paramètres de requête et le corps de réponse de Geoapify, à l'exception des textes de copyright, de conditions et de confidentialité, qui sont les nôtres et non ceux du fournisseur d'origine. Une requête actuellement construite pour les endpoints de géocodage de Geoapify peut être envoyée telle quelle à notre hôte, et le JSON renvoyé s'analyse de la même façon que le code existant l'attend déjà.
Ce périmètre restreint est délibéré. La plateforme de Geoapify couvre le calcul d'itinéraires, les isochrones et la recherche de lieux en plus du géocodage, et vouloir reproduire tout cela dans un seul hôte compatible lierait son calendrier de publication à des fonctionnalités très éloignées du géocodage lui-même. Limiter l'hôte aux endpoints de géocodage le rend simple à vérifier par rapport au service d'origine et facile à maintenir à niveau à mesure que My Geocode ajoute ses propres fonctionnalités.
Pour basculer, il suffit de changer un nom d'hôte et une clé, rien de plus. Cette clé s'authentifie avec la même souplesse que sur tous les hôtes que nous exploitons : 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'envoie votre client actuel, elle est acceptée ici aussi.
Les tarifs sous-jacents sont identiques à ceux du reste de la plateforme. Toute adresse bénéficie de 2 500 requêtes gratuites par jour sans aucune clé, comptées par réseau. Une clé ajoute ses propres 2 500 requêtes gratuites par jour en plus. Au-delà de ces deux quotas, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre tout pour 50 € par mois, le même tarif s'appliquant qu'un appel passe par cet hôte ou directement par /v1/forward.
Les en-têtes de quota accompagnent ici aussi chaque réponse : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit et X-Quota-Reset sont tous présents, offrant une visibilité qu'une intégration Geoapify directe n'offre pas d'elle-même.
Migrer une intégration de géocodage vers un nouveau fournisseur est aussi un bon moment pour renforcer la sécurité du compte de manière générale. Le réglage d'authentification à deux facteurs du tableau de bord se trouve à côté des clés d'API et de la facturation : l'activer sur un compte qui détient désormais une nouvelle clé ne demande qu'une étape de plus, et non un projet distinct.
Pour tout ce qui dépasse la réponse compatible standard, ajouter mg_extras=1 à une requête, ou un en-tête X-MG-Extras, ajoute des champs facultatifs par-dessus, sans modifier la structure de base sauf demande explicite.
La documentation complète de l'hôte se trouve sur /compatibility/geoapify/, et la référence générale sur la compatibilité, qui couvre les dix-sept hôtes, sur /docs/compatibility/. Si Geoapify alimente déjà une partie de votre stack, c'est un moyen peu contraignant de le comparer au nôtre.