Senden Sie einen API-Aufruf mit hundert Adressen darin, verbraucht dieser Aufruf hundert Anfragen, nicht eine. Wir zählen jedes Element einer Massen- oder Batch-Anfrage einzeln. Das ist eine einfache Regel, aber es lohnt sich, sie klar auszusprechen, denn sie bestimmt, wie ein Batch-Job geplant und budgetiert werden sollte.
Die Logik ist einfach, wenn Sie bedenken, was ein Batch-Aufruf tatsächlich tut. Eine einzelne HTTP-Anfrage, die hundert Adressen geokodiert, erledigt auf unserer Seite hundert Arbeitseinheiten: hundert Abfragen, hundert Antworten, hundert Zeilen in der Antwort. Das wie eine einzige Anfrage abzurechnen, hieße, einen Bruchteil eines Cents für etwas zu verlangen, das in Wahrheit hundert separate Informationen sind. Die Zählung pro Element hält die Preise an die tatsächlich geleistete Arbeit gebunden und nicht daran, wie oft Sie zufällig eine Verbindung geöffnet haben.
Das gilt gleichermaßen, ob Sie nahe am kostenlosen Kontingent sind oder für Ihre Nutzung bezahlen. Wenn Ihr Netz noch 400 Anfragen in seinem kostenlosen Tageskontingent übrig hat und Sie einen Batch mit 1.000 Adressen senden, werden 400 dieser Elemente vom kostenlosen Kontingent abgedeckt, und die restlichen 600 gehen zulasten des Prepaid-Guthabens oder eines Unlimited-Pakets. Die Kontingent-Header der Antwort bilden das genau ab: X-Quota-Used steigt um die Anzahl der Elemente, nicht um die Anzahl der Aufrufe, und X-Credits-Remaining spiegelt wider, was der Batch über den kostenlosen Anteil hinaus verbraucht hat.
Es bedeutet auch, dass es keinen Anreiz gibt, Arbeit in viele kleine Aufrufe aufzuteilen, um ein Kontingent auszutricksen, und keine Strafe dafür, Arbeit in weniger, größeren Aufrufen zu bündeln. Hundert Aufrufe mit je einem Element und ein Aufruf mit hundert Elementen kosten gleich viel und zählen gleich. Wählen Sie die Form, die sich für Ihren Code leichter schreiben und für Ihre Infrastruktur leichter betreiben lässt. Manche Teams bevorzugen viele kleine Aufrufe, weil sich ein Fehlschlag einfacher wiederholen lässt. Andere bevorzugen einen großen Aufruf, weil er weniger Roundtrips bedeutet. Beides kostet genau gleich viel.
Für die Planung macht das die Kapazitätsrechnung einfach. Wenn ein täglicher Job 50.000 Adressen verarbeiten muss, sind das 50.000 Anfragen, Punkt, unabhängig davon, ob sie als ein Aufruf, zehn Aufrufe oder fünfhundert Aufrufe gesendet werden. Bei 0,0001 € pro Anfrage über das kostenlose Kontingent hinaus ist diese Rechnung auf dem Papier in Sekunden erledigt.
Jeder Endpunkt und jeder Kompatibilitäts-Host folgt bei Batch- und Massenoperationen derselben Zählung pro Element. Es gibt keine separate, günstigere Preisstufe für Batches und auch keine separate, teurere. Eine Abfrage kostet gleich viel, ob sie allein eintrifft oder in einer Liste mit tausend anderen.
Wenn Sie einen Batch-Job für My Geocode entwickeln, planen Sie Ihr Anfragevolumen, indem Sie die Adressen, Koordinaten oder IPs zählen, die Sie senden, und nicht die Anzahl der HTTP-Aufrufe, die sie transportieren. Diese Zahl erscheint in Ihrem Kontingent, und sie ist es, die jede Rechnung widerspiegelt.