Zum Inhalt springen
POST AI agent ready /v1/address/autocomplete

API zur automatischen Vervollständigung von Adressen – Kostenlose Adressvorschläge

Senden Sie eine teilweise Adressabfrage und erhalten Sie bis zu 10 strukturierte Adressvorschläge mit Straße, Stadt, Bundesland, Land und GPS-Koordinaten zurück. Konzipiert für die Suche in Adressfeldern während der Eingabe. Unterstützt Sprachpräferenzen für lokalisierte Ergebnisse.

Parameters

stringrequired

Partial address to autocomplete.

number

Max suggestions to return (1-10).

string

ISO 639-1 language code for results.

Code examples

curl -X POST https://api.botoi.com/v1/address/autocomplete \
  -H "Content-Type: application/json" \
  -d '{"query":"1600 Amphithea","limit":3,"lang":"en"}'

When to use this API

Erstellen Sie Adressfelder für die Suche während der Eingabe

Verknüpfen Sie diesen Endpunkt mit einem Eingabefeld mit entprellten Anforderungen. Zeigen Sie während der Eingabe durch den Benutzer ein Dropdown-Menü mit übereinstimmenden Adressen an. Wenn sie eine auswählen, werden die Felder „Straße“, „Stadt“, „Bundesland“ und „Postleitzahl“ automatisch ausgefüllt.

Reduzieren Sie Formularfehler beim mobilen Checkout

Mobile Benutzer machen mehr Tippfehler als Desktop-Benutzer. Mit Vorschlägen zur automatischen Vervollständigung können sie auf die richtige Adresse tippen, anstatt sie vollständig einzugeben, wodurch die Zeit zum Ausfüllen des Formulars und die Fehlerquote gesenkt werden.

Suche nach Stromstandorten in Kartenanwendungen

Mithilfe der automatischen Vervollständigung können Benutzer nach Orten anhand des Namens oder der Adresse suchen. Jeder Vorschlag enthält Koordinaten, sodass Sie die Karte ohne einen separaten Geokodierungsaufruf auf das ausgewählte Ergebnis zentrieren können.

Frequently asked questions

Wie viele Vorschläge kann ich anfordern?
Legen Sie den Grenzwertparameter zwischen 1 und 10 fest. Der Standardwert ist 5. Die API gibt höchstens die Anzahl der gefundenen übereinstimmenden Ergebnisse zurück, die möglicherweise unter dem Grenzwert liegt.
Welche Sprachen werden unterstützt?
Übergeben Sie einen beliebigen ISO 639-1-Sprachcode (z. B. „de“ für Deutsch, „ja“ für Japanisch). Ergebnisse werden in der angeforderten Sprache zurückgegeben, wenn Übersetzungen verfügbar sind. Andernfalls wird auf die Landessprache zurückgegriffen.
Gibt es eine Mindestabfragelänge?
Die Abfrage muss mindestens ein Zeichen enthalten, das kein Leerzeichen ist. Kürzere Abfragen liefern umfassendere Ergebnisse. Für beste Vorschläge senden Sie mindestens 3-4 Zeichen.
Funktioniert dies für Firmennamen oder Straßenadressen?
Es funktioniert für beide. Der Geocoder gleicht Straßenadressen, Stadtteile, Städte und benannte Orte ab. Abhängig von der Abdeckung der Zuordnungsdatenbank können Unternehmensnamen übereinstimmen oder auch nicht.
Wie lange ist die Reaktionszeit?
Typische Antwortzeiten liegen je nach Auslastung des Geokodierungsdienstes bei 100–300 ms. Um ein reibungsloses Tipperlebnis zu gewährleisten, entprellen Sie Anfragen, die 150–200 ms nach Beendigung der Eingabe durch den Benutzer ausgelöst werden.

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