API für Adress-Autovervollständigung
Schlagen Sie Adressen, Straßen, Städte und Orte vor, während jemand tippt. Jeder Vorschlag enthält eigene Koordinaten und eine Genauigkeitsangabe, sodass Sie bereits alles haben, was Sie brauchen, wenn der Nutzer einen auswählt. Keine Session-Tokens, kein separater Detailaufruf, keine Abrechnung pro Session.
Beispiel
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/autocomplete?q=10+Downing&country=gb&limit=3"Die Antworten sind auf das Tippen abgestimmt: Sie kommen innerhalb weniger zehn Millisekunden zurück und verzeihen fehlende Buchstaben und vertauschte Wörter. Senden Sie proximity=lat,lon, um nahe gelegene Orte zuerst zu reihen, was bei Straßennamen, die es in vielen Orten gibt, sehr viel ausmacht.
Entprellen Sie Tastatureingaben auf etwa 150 ms. Bis eine typische Adresse ausgewählt ist, fallen 4 bis 6 Anfragen an.
{
"status": "ok",
"query": "10 Downing",
"suggestions": [
{
"text": "10 Downing Street, London SW1A 2AA, United Kingdom",
"lat": 51.503396,
"lon": -0.12764,
"type": "address",
"precision": "house",
"place_id": "gb.addr.7f3c2a19"
},
{
"text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom",
"lat": 52.203042,
"lon": 0.121811,
"type": "address",
"precision": "house",
"place_id": "gb.addr.a01d9e44"
},
{
"text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom",
"lat": 51.536118,
"lon": 0.137204,
"type": "address",
"precision": "house",
"place_id": "gb.addr.c58b7e02"
}
]
}Was Sie zurückbekommen
| Feld | Bedeutung |
|---|---|
text | Der Vorschlag, wie er angezeigt werden soll, in einer Zeile. |
lat, lon | Koordinaten des Vorschlags. Bei jedem Vorschlag vorhanden. |
type | address, street, postcode, city, region, country oder poi. |
precision | Dieselben vier Werte wie bei der Geokodierung. |
place_id | Eine stabile Kennung. Übergeben Sie sie an /v1/forward?place_id=..., wenn Sie die vollständigen Bestandteile und Begrenzungen des gewählten Vorschlags möchten. |
Wo sie eingesetzt wird
Adressformulare im Checkout
Ein Feld statt sechs. Über die place_id des gewählten Vorschlags werden die Bestandteile abgerufen, um den Rest des Formulars auszufüllen.
Suchfelder auf Karten
Übergeben Sie den Kartenmittelpunkt als proximity, damit „Hauptstraße“ die auf dem Bildschirm meint.
Places Autocomplete ersetzen
Der Google Maps JavaScript-Drop-in stellt google.maps.places.Autocomplete auf Basis dieses Endpunkts bereit, ohne Abrechnung pro Session.
Preis und Limits
Jeder Aufruf ist eine Anfrage. Es gibt keine Abrechnung pro Session und keine separaten Kosten für die Auswahl eines Vorschlags. Jeder Schlüssel hat 2.500 kostenlose Anfragen pro Tag; darüber hinaus jeweils 0,0001 € aus Prepaid-Guthaben oder nichts mit einem Unlimited-Schlüssel (50 € im Monat). Preise.