Envoyez un appel d'API contenant cent adresses, et cet appel consomme cent requêtes, pas une. Nous comptons individuellement chaque élément d'une requête groupée ou par lots. C'est une règle simple, mais elle mérite d'être clairement énoncée, car elle détermine la façon dont une tâche par lots doit être planifiée et budgétée.
La logique est évidente dès que l'on considère ce que fait réellement un appel par lots. Une seule requête HTTP qui géocode cent adresses représente cent unités de travail de notre côté : cent recherches, cent réponses, cent lignes dans la réponse. La facturer comme une seule requête reviendrait à facturer une fraction de centime pour ce qui constitue en réalité cent informations distinctes. Compter par élément relie la tarification au travail réellement effectué, et non au nombre de fois où vous avez ouvert une connexion.
Cela s'applique de la même manière, que vous soyez proche de la limite gratuite ou que vous payiez ce que vous consommez. Si votre réseau dispose encore de 400 requêtes dans son quota gratuit quotidien et que vous envoyez un lot de 1 000 adresses, 400 de ces éléments sont couverts par le quota gratuit et les 600 restants sont prélevés sur le crédit prépayé ou un forfait Unlimited. Les en-têtes de quota de la réponse le reflètent exactement : X-Quota-Used augmente du nombre d'éléments, et non du nombre d'appels, et X-Credits-Remaining reflète ce que le lot a consommé au-delà de la part gratuite.
Cela signifie aussi qu'il n'y a aucun intérêt à découper le travail en nombreux petits appels pour contourner un quota, ni aucune pénalité à le regrouper en appels moins nombreux et plus volumineux. Cent appels d'un élément et un appel de cent éléments coûtent la même chose et comptent de la même façon. Choisissez la forme la plus simple à écrire pour votre code et à exécuter pour votre infrastructure. Certaines équipes préfèrent de nombreux petits appels parce qu'il est plus simple de relancer un échec. D'autres préfèrent un seul gros appel parce qu'il implique moins d'allers-retours. Les deux sont facturés de manière identique.
Pour la planification, cela rend le calcul de capacité facile. Si une tâche quotidienne doit traiter 50 000 adresses, cela fait 50 000 requêtes, point final, qu'elles soient envoyées en un appel, dix appels ou cinq cents appels. À 0,0001 € par requête au-delà du quota gratuit, ce calcul se fait en quelques secondes sur le papier.
Chaque endpoint et chaque hôte compatible suivent le même comptage par élément pour les opérations par lots et groupées. Il n'existe ni palier tarifaire par lots distinct et moins cher, ni palier distinct plus cher. Une recherche coûte la même chose, qu'elle arrive seule ou au milieu d'une liste de mille autres.
Si vous construisez une tâche par lots avec My Geocode, planifiez votre volume de requêtes en comptant les adresses, coordonnées ou IP que vous envoyez, et non le nombre d'appels HTTP qui les transportent. C'est ce nombre qui apparaît dans votre quota, et c'est lui que reflétera toute facture.