POST AI agent ready /v1/geo/geocode

Geokodierungs-API – Konvertieren Sie Adressen in Lat/Lng-Koordinaten

Senden Sie eine Adresszeichenfolge (Straße, Stadtname, Wahrzeichen oder Postleitzahl) und erhalten Sie den entsprechenden Breitengrad, Längengrad, Anzeigenamen und Standorttyp. Unterstützt durch den OpenStreetMap Nominatim-Dienst. Unterstützt weltweite Adressen in jeder Sprache.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/geocode \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Konvertieren Sie vom Benutzer eingegebene Adressen in Karten-Pins in Ihrer App

Wenn ein Benutzer eine Adresse in ein Formular eingibt, geokodieren Sie sie und platzieren Sie eine Markierung auf der Karte. Dies ersetzt in vielen Anwendungsfällen die Notwendigkeit einer kostenpflichtigen Google Maps Geocoding API.

Bereichern Sie Ihre CRM- oder Datenbankdatensätze mit Koordinaten

Führen Sie eine Batch-Geokodierung von Kundenadressen durch, um Lat/Lng-Felder hinzuzufügen. Verwenden Sie die Koordinaten für Umgebungssuchen, Lieferzonenberechnungen oder geografische Berichte.

Frequently asked questions

Welcher Geokodierungsanbieter betreibt diesen Endpunkt?

OpenStreetMap Nominatim. Die Ergebnisse spiegeln die Qualität der OpenStreetMap-Daten wider, die in den meisten Ländern gut ist, in ländlichen Gebieten oder Entwicklungsgebieten jedoch möglicherweise weniger detailliert ist.

Unterstützt dieser Endpunkt nicht-englische Adressen?

Ja. Nominatim unterstützt Adressen in den meisten Sprachen und Skripten. Sie können Adressen in Japanisch, Arabisch, Kyrillisch oder einer anderen von OpenStreetMap unterstützten Sprache senden.

Was passiert, wenn die Adresse nicht eindeutig ist oder nicht gefunden wird?

Wenn keine Ergebnisse übereinstimmen, gibt die API den Fehler 404 NOT_FOUND zurück. Bei mehrdeutigen Adressen gibt die API die höchste Übereinstimmung zurück. Seien Sie für eine bessere Genauigkeit so genau wie möglich (einschließlich Stadt, Bundesland, Land).

Gibt es eine Ratenbegrenzung für Geokodierungsanfragen?

Der anonyme Zugriff ermöglicht 5 Anfragen pro Minute. Mit einem API-Schlüssel wird die Ratenbegrenzung durch Ihren Plan bestimmt. Nominatim selbst hat eine Richtlinie von 1 Anfrage/Sekunde, die dieser Endpunkt respektiert.

Kann ich IP-Adressen mit diesem Endpunkt geokodieren?

Nein. Dieser Endpunkt wandelt Straßenadressen in Koordinaten um. Verwenden Sie für die IP-Geolokalisierung den Endpunkt /v1/ip/lookup.

Get your API key

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