Une grande partie du code écrit pour Mapbox Geocoding se trouve dans des applications front-end, des applications mobiles et des outils internes où l'appel de géocodage lui-même n'est qu'un petit détail facile à manquer, enfoui dans un système plus vaste. Y changer de fournisseur suppose généralement de retrouver chaque endroit où se trouve ce détail avant de pouvoir faire quoi que ce soit d'autre. Notre hôte compatible vise à réduire ce travail à presque rien.
Il reproduit à l'identique le format de requête et la structure de réponse de Mapbox, à l'exception des textes de copyright, de conditions et de confidentialité, qui sont ceux de My Geocode. Partout où votre code envoie actuellement une requête au format Mapbox, il peut envoyer cette même requête à notre hôte, et la réponse renvoyée s'analysera de la même façon que votre code existant l'attend déjà.
L'authentification suit notre modèle habituel, sans imposer non plus de réécriture de cette partie. 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, selon la façon dont votre client s'authentifie actuellement. Les quatre fonctionnent sur tous nos hôtes et tous nos endpoints.
Les tarifs ne changent pas selon l'hôte qui a traité la requête. Toute adresse bénéficie de 2 500 requêtes gratuites par jour sans clé, comptées par réseau plutôt que par appelant. Une clé ajoute ses propres 2 500 requêtes gratuites par jour supplémentaires. 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. L'hôte compatible coûte exactement le même prix que nos endpoints natifs /v1/forward et /v1/reverse.
Les en-têtes de quota sont joints à chaque réponse, quel que soit le format, ce qui offre une visibilité qu'une intégration Mapbox directe ne fournit pas d'elle-même : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit et X-Quota-Reset apparaissent sur cet hôte comme partout ailleurs.
Pour tout ce qui dépasse la structure de réponse compatible, mg_extras=1 dans la requête, ou un en-tête X-MG-Extras, ajoute des champs supplémentaires facultatifs par-dessus sans modifier la structure de base. L'option est désactivée par défaut, donc la réponse correspond à la structure de Mapbox tant que vous ne demandez pas explicitement davantage.
L'hôte se trouve sur /compatibility/mapbox/, et des conseils généraux pour migrer une intégration sont disponibles sur /docs/compatibility/. Si vous maintenez aujourd'hui une intégration au format Mapbox, le tester vous coûte une clé et une URL de base modifiée.