Zum Inhalt springen
POST AI agent ready /v1/geo/batch

Batch-Geokodierungs-API – Kostenlose Massenadresse zu Koordinaten

Senden Sie ein Array von bis zu 10 Freiformadressen und empfangen Sie die Koordinaten für jede. Adressen werden parallel geokodiert. Einzelne Fehler geben eine Fehlermeldung für diese Adresse zurück, ohne dass der gesamte Stapel fehlschlägt. Die Antwort umfasst Gesamt-, gelöste und fehlgeschlagene Zählungen.

Parameters

arrayrequired

Array of address strings to geocode (max 10).

Code examples

curl -X POST https://api.botoi.com/v1/geo/batch \
  -H "Content-Type: application/json" \
  -d '{"addresses":["London, UK","Paris, France","xyzzy nowhere"]}'

When to use this API

Zeichnen Sie Kundenstandorte auf einer Karte ein

Geokodieren Sie eine Liste von Kundenadressen aus Ihrem CRM-Export. Verwenden Sie die Koordinaten, um Stecknadeln auf einer Karte für die Gebietsplanung, Lieferroute oder Analyse der Vertriebsabdeckung zu platzieren.

Bereichern Sie CSV-Importe mit Koordinaten

Verarbeiten Sie hochgeladene CSV-Dateien mit Adressen. Führen Sie eine Batch-Geokodierung der Adressspalte durch und hängen Sie Breiten- und Längengrade an jede Zeile an, bevor Sie sie in Ihrer Datenbank speichern.

Validieren Sie mehrere Adressen in einer Formularübermittlung

Wenn ein Benutzer ein Formular mit mehreren Adressen einreicht (z. B. Rechnung + Versand + Alternative), geokodieren Sie alle Adressen in einem API-Aufruf. Markieren Sie alle Probleme, die sich nicht lösen lassen, bevor Sie die Übermittlung annehmen.

Frequently asked questions

Was ist die maximale Anzahl an Adressen pro Anfrage?
Sie können bis zu 10 Adressen pro Anfrage senden. Teilen Sie für größere Mengen Ihre Liste in 10er-Blöcke auf und senden Sie mehrere Anfragen.
Was passiert, wenn eine Adresse ausfällt?
Fehlerhafte Adressen geben lat: null, lng: null und eine Fehlermeldung zurück. Der Rest des Stapels wird normal verarbeitet. Überprüfen Sie die Fehleranzahl in der Antwort, um problematische Adressen zu identifizieren.
Werden die Geokodierungsaufrufe parallel durchgeführt?
Ja. Alle Adressen im Stapel werden für schnellere Reaktionszeiten gleichzeitig geokodiert. Ein Stapel von 10 Adressen dauert ungefähr so ​​lange wie eine einzelne Geokodierungsanfrage.
Kann ich mehr als 10 Adressen geokodieren?
Nicht in einer einzigen Anfrage. Teilen Sie Ihre Liste in 10er-Batches auf und senden Sie mehrere Anfragen. Mit einem kostenpflichtigen Plan können Sie mehrere Batch-Anfragen pro Sekunde senden.
Ist das derselbe Geocoder wie /v1/geo/geocode?
Ja. Der Batch-Endpunkt verwendet denselben OpenStreetMap Nominatim-Geocoder wie der Einzeladressen-Endpunkt. Die Ergebnisse sind für die gleiche Eingabe identisch.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs