Die Places API unterstützt die vorhandenen APIs Autocomplete und Query Autocomplete. Wenn Sie mit diesen APIs vertraut sind, nimmt Autocomplete (New) die folgenden Änderungen vor:
- Autocomplete (New) verwendet HTTP POST-Anfragen. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Im Gegensatz dazu werden bei den vorhandenen APIs URL-Parameter mit einer HTTP-GET-Anfrage übergeben.
- „Autocomplete (New)“ unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
- In „Autocomplete (New)“ wird nur JSON als Antwortformat unterstützt.
In der folgenden Tabelle sind Parameter in den vorhandenen Autocomplete und Query Autocomplete APIs aufgeführt, die für „Autocomplete (New)“ umbenannt oder geändert wurden, sowie Parameter, die nicht mehr unterstützt werden.
Aktueller Parameter | Neuer Parameter | Hinweise |
---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Wenn Sie sowohl locationBias als auch locationRestriction weglassen, verwendet die API standardmäßig die IP-Gewichtung. |
|
offset |
inputOffset |
|
radius |
locationBias oder locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Beispielanfrage
Im folgenden Beispiel für eine GET-Anfrage wird die vorhandene „Place Autocomplete“-Funktion verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu Orten namens „Amoeba“ an, die vom Typ establishment
sind und alle Parameter als URL-Parameter übergeben:
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'
Mit „Autocomplete New“ stellen Sie eine POST-Anfrage und übergeben alle Parameter im JSON-Anfragetext oder in Headern als Teil der POST-Anfrage. In diesem Beispiel wird auch eine Feldmaske verwendet, sodass die Antwort nur den Anzeigenamen und die formatierte Adresse des Orts enthält:
curl -X POST -d '{ "input": "Amoeba", "locationBias": { "circle": { "center": { "latitude": 37.76999, "longitude": -122.44696 }, "radius": 500.0 } } }' \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ https://places.googleapis.com/v1/places:autocomplete