De nombreuses intégrations cartographiques ont été développées il y a des années avec Bing Maps REST Services et tournent depuis sans modification, faute d'une raison convaincante de les réécrire. Nous pensons qu'il en existe désormais une : un hôte compatible qui accepte les mêmes requêtes et renvoie des réponses de même structure, avec des tarifs et des quotas transparents dès le premier appel.
Notre hôte compatible Bing Maps REST Services reproduit à l'identique les paramètres de requête et le corps de réponse du service d'origine, à l'exception des textes de copyright, de conditions et de confidentialité, qui concernent My Geocode et non le fournisseur d'origine. Le code existant qui construit des requêtes au format Bing, analyse des réponses au format Bing, ou les deux, peut être dirigé vers notre hôte sans aucune réécriture.
Pour y parvenir, il suffit de changer deux choses : le nom d'hôte auquel vos requêtes sont envoyées et la clé avec laquelle vous vous authentifiez. Cette clé peut être transmise de la manière dont votre intégration en envoie déjà une : 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 simple paramètre de requête. Ces quatre méthodes fonctionnent de façon identique sur tous les hôtes My Geocode, y compris celui-ci.
Les tarifs derrière la couche de compatibilité sont les mêmes que partout ailleurs sur la plateforme. Chaque adresse bénéficie de 2 500 requêtes gratuites par jour sans avoir besoin de clé, comptées par réseau afin qu'une connexion partagée ne puisse pas être répartie sur plusieurs clés pour multiplier le niveau gratuit. Chaque clé ajoute ses propres 2 500 requêtes gratuites par jour en plus. Au-delà de ces quotas, l'utilisation est décomptée du crédit prépayé à 0,0001 € la requête ou couverte par un forfait Unlimited à 50 € par mois, et ce tarif s'applique quel que soit l'hôte ou l'endpoint visé par la requête.
La visibilité sur les quotas ne disparaît pas parce que la structure de réponse correspond à celle d'un autre fournisseur. Chaque appel renvoie toujours X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining et le reste de nos en-têtes standard, afin que vous sachiez toujours exactement où en est une clé ou un réseau donné, ce que le service d'origine n'offre pas sous cette forme.
Pour les équipes qui veulent davantage que la réponse strictement compatible, mg_extras=1 dans la requête, ou un en-tête X-MG-Extras, ajoute des champs facultatifs à la structure standard sans la perturber. Sans cette option, la réponse est structurellement impossible à distinguer de celle qu'aurait renvoyée l'API d'origine.
Des guides de migration expliquant, endpoint par endpoint, comment transférer une intégration existante sont disponibles sur /docs/compatibility/, et l'hôte lui-même est documenté sur /compatibility/bing-maps/. Le tester ne coûte rien de plus que quelques minutes et une clé.