MapQuest Geocoding fait partie de nombreuses applications anciennes, dont certaines n'ont pas touché à leur code de recherche d'adresses depuis des années parce qu'il continue tout simplement de fonctionner. Notre hôte compatible est conçu exactement pour cette situation : un code qui fonctionne bien, que personne ne veut réécrire, mais qu'une équipe aimerait tout de même sortir d'une intégration vieillissante sans tout reconstruire.
L'hôte reproduit à l'identique les paramètres de requête et le corps de réponse de MapQuest, à 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 formulée pour les endpoints de géocodage de MapQuest peut être envoyée telle quelle à notre hôte, et la réponse renvoyée s'analyse de la même façon que le code existant l'attend déjà.
Les seuls changements nécessaires sont un nom d'hôte et une clé. Cette clé s'authentifie avec celle de nos quatre méthodes standard qui correspond à votre intégration actuelle : un en-tête X-API-Key, un en-tête Authorization: Bearer, l'authentification HTTP Basic avec la clé comme nom d'utilisateur, ou un paramètre de requête.
Obtenir cette clé n'exige pas d'avoir d'abord terminé la vérification du compte. Les clés d'un compte nouvellement créé fonctionnent pendant une période de grâce avant que My Geocode n'exige la confirmation de l'adresse e-mail d'inscription, après quoi les clés non vérifiées sont mises en pause plutôt que de simplement échouer. Cela compte justement pour ce type de test de migration, où quelqu'un veut diriger une intégration ancienne vers un nouvel hôte un vendredi après-midi sans attendre un aller-retour par e-mail.
Les tarifs suivent la même structure que partout ailleurs sur My Geocode. 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, séparément. Au-delà de ces quotas, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre l'utilisation pour 50 € par mois, sans différence de tarif entre cet hôte et les autres.
Chaque réponse comporte les mêmes en-têtes de quota que le reste de la plateforme : 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. Deux d'entre eux, X-Key-IPs-Used et X-Key-IPs-Limit, suivent une donnée propre aux clés plutôt qu'aux réseaux : chaque clé peut être appelée depuis un petit nombre glissant d'adresses IP, ce qui empêche de partager une clé entre des serveurs sans lien entre eux tout en tolérant un déploiement normal qui change l'adresse sortante d'une application.
Pour les projets qui veulent plus que ce que renvoie la réponse compatible, mg_extras=1 dans la requête, ou un en-tête X-MG-Extras, ajoute des champs facultatifs à la structure standard, entièrement sur activation.
La documentation de l'hôte se trouve sur /compatibility/mapquest/, et une présentation plus large de la compatibilité sur la plateforme sur /docs/compatibility/. Si MapQuest Geocoding tourne encore discrètement dans votre stack, c'est un moyen peu coûteux de voir à quoi ressemble une structure de quotas moderne sous la même forme familière.