HERE Geocoding and Search équipe bon nombre de logiciels de logistique, d'automobile et de localisation, souvent comme un élément parmi d'autres plutôt que comme le système entier. Quand un fournisseur est intégré aussi profondément, évaluer une alternative revient généralement à mettre en balance un coût d'ingénierie et un bénéfice incertain. Notre hôte compatible HERE est conçu pour retirer entièrement le coût d'ingénierie de cette équation.
L'hôte reproduit à l'identique les paramètres de requête et le corps de réponse de HERE, les seules différences étant les textes de copyright, de conditions et de confidentialité, qui sont les nôtres et non ceux du fournisseur d'origine. Le code client qui construit déjà des requêtes au format HERE et lit des réponses au format HERE n'a pas besoin d'être modifié. Il lui faut seulement un autre nom d'hôte et une clé My Geocode.
Cette clé fonctionne avec la même souplesse sur tous les hôtes que nous exploitons, y compris celui-ci : 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. Utilisez celle qu'envoie déjà votre client existant, puisque les quatre sont reconnues sur chaque endpoint et chaque hôte compatible, sans exception.
Sous la surface compatible, les tarifs sont les nôtres, et ils sont identiques partout sur la plateforme. Toute adresse bénéficie de 2 500 requêtes gratuites par jour sans aucune clé, comptées par réseau afin que le niveau gratuit corresponde à quelque chose comme un site ou un bureau plutôt qu'à chaque appareil qui y transite. Une clé ajoute ses propres 2 500 requêtes gratuites par jour, séparément. Au-delà de ces deux 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 supplément pour l'utilisation d'un hôte compatible plutôt que d'un endpoint natif.
Chaque réponse, compatible ou non, comporte l'ensemble de nos en-têtes de quota : 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. Cela offre un niveau de transparence sur l'utilisation que l'API d'origine n'intègre pas, sans modifier le corps de la réponse lui-même.
Si un projet a besoin de plus que ce que renvoie la structure compatible, ajouter mg_extras=1 à la requête, ou envoyer un en-tête X-MG-Extras, ajoute des champs facultatifs comme l'altitude du sol, entièrement sur activation. Sans cette option, la réponse correspond précisément au format de HERE.
L'hôte compatible est documenté sur /compatibility/here/, et une présentation plus large du fonctionnement de la migration sur les dix-sept hôtes se trouve sur /docs/compatibility/. Un seul appel de test suffit généralement pour voir s'il convient.