Traiter une liste d'adresses une par une, un appel HTTP après l'autre, fonctionne bien pour de petits volumes et devient vite fastidieux à grande échelle. Nous prenons désormais en charge l'envoi d'une liste d'adresses complète en un seul appel groupé, ce qui réduit les allers-retours nécessaires pour traiter une longue liste sans rien changer à la tarification.
La règle de décompte est exactement celle que nous appliquons partout ailleurs sur la plateforme : chaque adresse d'un appel groupé compte pour une requête, et non l'appel dans son ensemble. Envoyez une liste de cinq cents adresses en un seul appel groupé, et cela consomme cinq cents requêtes sur le quota applicable, qu'il s'agisse du quota quotidien gratuit, du crédit prépayé à 0,0001 € par requête ou de la couverture d'un forfait Unlimited. Il n'y a ni remise ni pénalité à regrouper le travail en un seul appel plutôt qu'à l'envoyer en plusieurs appels plus petits.
Les en-têtes de quota reflètent eux aussi fidèlement l'appel groupé. X-Quota-Used, X-Quota-Free-Remaining et X-Credits-Remaining évoluent tous du nombre d'adresses réellement traitées dans l'appel : une grosse requête groupée met donc à jour votre quota visible exactement comme l'auraient fait cinq cents appels individuels, mais en un seul aller-retour au lieu de cinq cents.
Cette fonctionnalité vise précisément le type de charge qui obligeait auparavant à écrire une boucle autour d'appels portant sur une seule adresse : importer une liste de clients à géocoder, nettoyer une base d'adresses ou préparer un gros traitement par lots qui s'exécute selon un planning plutôt qu'en réponse à une action ponctuelle d'un utilisateur. Envoyer cette liste en un seul appel groupé réduit la charge liée à la gestion de nombreuses connexions HTTP distinctes, ce qui est particulièrement utile pour les tâches qui tournent sur une infrastructure ayant ses propres contraintes de connexion ou de débit, en plus des nôtres.
L'authentification et le comportement général sont inchangés : les mêmes quatre méthodes de clé fonctionnent, les mêmes règles de quota s'appliquent, et le même quota gratuit couvre des tests conséquents avant tout coût réel. Comme pour toute recherche basée sur des adresses, les résultats de géocodage direct et inverse font encore partie de notre backend en cours de développement pour des résultats réels complets ; cette capacité groupée est donc documentée spécifiquement autour de son format de requête et de son mode de décompte.
La documentation complète sur l'envoi de requêtes groupées, y compris le format des requêtes, est disponible sur /docs/forward-geocoding/ et /docs/reverse-geocoding/. Si votre processus boucle actuellement sur des appels à adresse unique, cela vaut le coup d'œil pour tout traitement portant sur plus de quelques adresses à la fois.