Geocodio s'est fait une réputation grâce à un géocodage par lots simple, et bon nombre d'intégrations construites autour de ce service s'appuient fortement sur ce fonctionnement par lots. Notre hôte compatible reproduit à l'identique les structures de requête unitaire et par lots, afin que cette dépendance ne devienne pas un obstacle au changement.
L'hôte reproduit précisément les paramètres de requête et le corps de réponse de Geocodio, à 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 Geocodio, unitaires ou par lots, peuvent être envoyées telles quelles à notre hôte, et les réponses s'analysent de la même façon que le code existant l'attend déjà.
Les requêtes par lots sont comptées ici de la même façon que partout sur la plateforme : chaque adresse d'un appel par lots compte comme une requête, et non l'appel dans son ensemble. Le suivi des quotas reste ainsi exact, qu'un appel contienne une seule adresse ou plusieurs.
Un lot de cinq cents adresses envoyé en un seul appel est décompté comme cinq cents requêtes sur le quota, et sur le crédit prépayé si les quotas gratuits sont déjà épuisés, exactement comme le seraient cinq cents appels distincts. C'est cette granularité qui permet à X-Quota-Used et X-Credits-Remaining de rester exacts dès la fin d'un gros lot, au lieu de se mettre à jour quelques minutes plus tard, une fois qu'une tâche en arrière-plan a rattrapé son retard.
L'authentification repose sur nos quatre options standard : 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, selon ce qu'utilise déjà votre intégration Geocodio actuelle.
Les tarifs sont les mêmes sur toute la plateforme. Toute adresse bénéficie de 2 500 requêtes gratuites par jour sans clé, comptées par réseau. Une clé ajoute ses propres 2 500 requêtes gratuites par jour. Au-delà, le crédit prépayé coûte 0,0001 € la requête, ou un forfait Unlimited couvre tout pour 50 € par mois, le même tarif s'appliquant aux recherches unitaires comme aux éléments d'un lot.
Les codes promo du tableau de bord sont un moyen courant de tester une migration fortement axée sur les lots comme celle-ci sans engager de budget réel au départ : ils créditent un solde sur le compte avant de décider de l'alimenter vraiment par du crédit prépayé ou un forfait Unlimited.
Les en-têtes de quota accompagnent chaque réponse, par lots ou unitaire : X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used et X-Credits-Remaining indiquent exactement combien d'éléments un lot a consommés, avec une précision sur laquelle il est facile de s'appuyer pour planifier.
Si un projet veut davantage que la réponse compatible standard, mg_extras=1 dans la requête, ou un en-tête X-MG-Extras, ajoute des champs supplémentaires facultatifs par-dessus, sans toucher à la structure de base sauf demande explicite.
L'hôte est documenté sur /compatibility/geocodio/, et des conseils généraux pour migrer une intégration existante se trouvent sur /docs/compatibility/. Tester un appel par lots sur le nouvel hôte est un moyen rapide de confirmer que le décompte des quotas se comporte exactement comme prévu avant de lui confier un volume réel.