Eine Adressliste Eintrag für Eintrag zu verarbeiten, ein HTTP-Aufruf nach dem anderen, funktioniert bei kleinen Mengen gut und wird bei jeder realen Größenordnung schnell mühsam. Wir unterstützen jetzt das Senden einer ganzen Adressliste als einen einzigen Bulk-Aufruf, was die nötigen Roundtrips für eine große Liste reduziert, ohne etwas an der Preisgestaltung zu ändern.
Die Zählregel ist hier genau dieselbe, die wir überall sonst auf der Plattform anwenden: Jede Adresse in einem Bulk-Aufruf zählt als eine Anfrage, nicht der Aufruf als Ganzes. Senden Sie eine Liste mit fünfhundert Adressen in einem Bulk-Aufruf, verbraucht das fünfhundert Anfragen vom jeweils geltenden Kontingent, ob das kostenlose Tageskontingent, Prepaid-Guthaben zu 0,0001 € pro Anfrage oder die Abdeckung durch ein Unlimited-Paket. Es gibt weder einen Rabatt noch einen Aufschlag dafür, Arbeit in einem einzigen Aufruf zu bündeln, statt sie als viele kleinere zu senden.
Auch die Kontingent-Header bilden den Bulk-Aufruf korrekt ab. X-Quota-Used, X-Quota-Free-Remaining und X-Credits-Remaining ändern sich alle um die Anzahl der Adressen, die im Aufruf tatsächlich verarbeitet wurden. Eine große Bulk-Anfrage aktualisiert Ihr sichtbares Kontingent also genauso, wie es fünfhundert einzelne Aufrufe getan hätten, nur in einem Roundtrip statt in fünfhundert.
Das zielt genau auf die Art von Arbeitslast, für die man früher eine Schleife um Einzeladress-Aufrufe schreiben musste: den Import einer Kundenliste, die geokodiert werden muss, die Bereinigung einer Adressdatenbank oder die Vorbereitung eines großen Batch-Jobs, der nach Zeitplan läuft statt als Reaktion auf eine einzelne Nutzeraktion. Diese Liste in einem Bulk-Aufruf zu senden, reduziert den Aufwand für die Verwaltung vieler separater HTTP-Verbindungen, was besonders nützlich für Jobs ist, die auf einer Infrastruktur mit eigenen Verbindungs- oder Ratenbeschränkungen jenseits unserer laufen.
Authentifizierung und allgemeines Verhalten bleiben unverändert: Dieselben vier Schlüsselmethoden funktionieren, dieselben Kontingentregeln gelten, und dasselbe kostenlose Kontingent deckt aussagekräftige Tests ab, bevor echte Kosten entstehen. Wie bei jeder adressbasierten Abfrage sind die Ergebnisse der Geokodierung und Reverse-Geokodierung noch Teil unseres derzeit in Entwicklung befindlichen Backends für befüllte, reale Ergebnisse, daher ist diese Bulk-Funktion gezielt anhand ihrer Anfragestruktur und ihres Zählverhaltens dokumentiert.
Die vollständige Dokumentation zum Senden von Bulk-Anfragen, einschließlich der Anfrageformatierung, finden Sie unter /docs/forward-geocoding/ und /docs/reverse-geocoding/. Wenn Ihr Workflow derzeit Einzeladress-Aufrufe in einer Schleife ausführt, lohnt sich ein Blick darauf für alles, was mehr als eine Handvoll Adressen auf einmal verarbeitet.