LocationIQ s'est fait une place dans de nombreuses stacks qui ont commencé petites puis ont grandi, souvent parce qu'il était facile à adopter au départ. Notre hôte compatible vise exactement ce type d'intégration : une intégration qui fonctionne bien aujourd'hui, qui n'était pas censée être définitive et qui n'a jamais valu la peine d'être réécrite.
L'hôte reproduit à l'identique les paramètres de requête et le corps de réponse de LocationIQ, à l'exception des textes de copyright, de conditions et de confidentialité, qui sont ceux de My Geocode. Les requêtes formulées pour les endpoints de LocationIQ peuvent être envoyées sans modification à 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à.
Cette exactitude n'est pas le fruit d'un effort particulier consacré à chaque fournisseur. Chaque hôte compatible repose sur le même système de facturation, de quotas et de comptes que le reste de My Geocode, si bien qu'en créer un nouveau est surtout un exercice de correspondance, qui consiste à faire concorder les noms de champs et les formats de paramètres avec ce qu'envoient déjà les clients d'un fournisseur donné, plutôt qu'à mettre en place un backend distinct. C'est pourquoi les tarifs, l'authentification et le suivi des quotas se comportent de façon identique sur les dix-sept hôtes, au lieu de diverger les uns des autres avec le temps.
L'authentification suit le même modèle que sur tous les hôtes de la plateforme. 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 ce que fait déjà votre intégration LocationIQ actuelle. Les quatre sont acceptées ici sans exception, si bien que changer de fournisseur implique rarement de toucher à votre client HTTP.
Les tarifs ne varient pas selon l'hôte ou l'endpoint qui traite un appel. Toute adresse bénéficie de 2 500 requêtes gratuites par jour sans clé, comptées par réseau afin que le quota corresponde logiquement à une connexion partagée plutôt qu'à chaque appareil qui se trouve derrière. Une clé ajoute ses propres 2 500 requêtes gratuites par jour supplémentaires, suivies séparément du quota sans clé du même réseau. Au-delà, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre tout pour 50 € par mois.
Chaque réponse comporte l'ensemble de nos en-têtes de quota, quel que soit l'hôte compatible qui l'a traitée : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used et X-Credits-Remaining sont joints aux réponses de cet hôte exactement comme à celles de nos endpoints natifs, si bien que tout ce qui s'appuie sur ces en-têtes continue de fonctionner sans changement.
Si un projet a besoin de plus que ce que fournit la 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, entièrement sur activation. Pour un appel de géocodage, cela peut inclure l'altitude du sol aux coordonnées renvoyées, issue de la même source que celle qui répond directement à /v1/elevation. Sans cette option, le format de réponse correspond précisément à celui de LocationIQ, sans surprise pour la logique d'analyse existante.
Les comptes qui font le changement et constatent qu'il tient sous un trafic réel finissent souvent par le recommander aux autres membres de leur équipe qui paient encore le fournisseur d'origine. Le programme de parrainage du tableau de bord, sur /dashboard/referrals, est conçu précisément pour ce type de bouche-à-oreille.
L'hôte est documenté sur /compatibility/locationiq/, et des conseils généraux pour changer de fournisseur se trouvent sur /docs/compatibility/. Un seul appel de test avec une nouvelle clé suffit généralement à confirmer qu'il s'intègre proprement à une intégration existante.