Geocode.Farm assure discrètement le géocodage d'un certain nombre de petites applications et d'outils internes depuis longtemps, souvent intégré lors d'une première version puis laissé tel quel. Notre hôte compatible est conçu précisément pour ce type d'intégration, qui fonctionne bien et mérite une voie d'évolution simple plutôt qu'une réécriture.
L'hôte reproduit à l'identique les paramètres de requête et le corps de réponse de Geocode.Farm, à l'exception des textes de copyright, de conditions et de confidentialité, qui sont ceux de My Geocode. Les requêtes actuellement formulées pour les endpoints de Geocode.Farm peuvent être dirigées telles quelles vers notre hôte, et la réponse est renvoyée dans la structure que le code existant attend déjà.
Pour basculer, il faut changer un nom d'hôte et une clé, sans rien modifier à la logique de construction des requêtes ni d'analyse des réponses. Cette clé peut s'authentifier 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 qu'envoie déjà votre intégration actuelle.
Les intégrations anciennes de ce type ont souvent été écrites directement avec des appels HTTP bruts, avant qu'un SDK n'existe pour le fournisseur ou ne vaille la peine d'être adopté. My Geocode publie ses propres SDK, répertoriés sur /sdks/, pour ceux qui préfèrent abandonner complètement les appels HTTP bruts pendant qu'ils modifient déjà cette partie du code, même si l'hôte compatible n'exige rien de tel.
Les tarifs suivent les mêmes règles que sur le reste de la plateforme. 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 en plus. Au-delà, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre l'utilisation pour 50 € par mois, le même tarif s'appliquant quel que soit l'hôte qui a traité l'appel.
Chaque réponse 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, ce qui offre une visibilité sur l'utilisation qu'une intégration plus petite et plus ancienne n'a peut-être jamais eue.
Pour les projets qui veulent davantage que ce que renvoie la réponse compatible, ajouter mg_extras=1 à la requête, ou un en-tête X-MG-Extras, ajoute des champs supplémentaires facultatifs par-dessus, entièrement sur activation et désactivés par défaut.
Nos hôtes compatibles publiés sont ainsi au nombre de dix-sept, couvrant le géocodage, la géolocalisation IP et l'altitude. Atteindre ce nombre ne visait pas tant à couvrir tous les fournisseurs possibles qu'à couvrir ceux qu'utilisent réellement les intégrations en production, c'est pourquoi la liste couvre ces trois catégories au lieu de se concentrer entièrement sur l'une d'elles.
L'hôte lui-même est documenté sur /compatibility/geocode-farm/, et la liste complète se trouve sur /compatibility/. Si Geocode.Farm fait partie d'une intégration ancienne de votre stack, c'est un moyen peu contraignant de voir à quoi ressemble une structure de quotas moderne derrière la même forme de requête.