Die Places API unterstützt die bestehenden APIs Autocomplete und Query Autocomplete. Wenn Sie mit diesen APIs vertraut sind, werden durch die Funktion „Autocomplete (Neu)“ die folgenden Änderungen vorgenommen:
- Für „Autocomplete (New)“ werden HTTP-POST-Anfragen verwendet. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Im Gegensatz dazu mit den vorhandenen APIs verwenden, übergeben Sie URL-Parameter mithilfe eines HTTP GET-Anfrage
- Die automatische Vervollständigung (New) unterstützt beide API-Schlüssel. und OAuth-Tokens als Authentifizierungsmechanismus.
- In „Autocomplete (New)“ wird nur JSON als Antwortformat unterstützt.
In der folgenden Tabelle sind Parameter in den bestehenden Autocomplete API und Query Autocomplete API aufgeführt, die für die Autocomplete API (neu) umbenannt oder geändert wurden, oder 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-Voreingenommenheit. |
|
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 In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu Orten namens „Amoeba“ vom Typ establishment an und übergeben alle Parameter als URL-Parameter:
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 Sie alle Parameter im JSON-Anfragetext oder in Headern als Teil der POST-Anfrage
Feldmasken sind für Anfragen vom Typ „Autocomplete (New)“ nicht erforderlich, können aber verwendet werden, um in der Antwort nach bestimmten Ergebnissen zu filtern. Beispiel:
-Anfrage eine Feldmaske verwendet, sodass die Antwort nur die
suggestions.placePrediction.text des Vorschlags:
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' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete
Weitere Informationen zur Verwendung von Feldmasken finden Sie unter Places Details (Places Details). (Neu).