Die Places API unterstützt die APIs Autocomplete (Legacy) und Query Autocomplete (Legacy). 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. Bei den älteren APIs werden URL-Parameter dagegen über eine HTTP-GET-Anfrage übergeben.
- Die Funktion „Autocomplete (Neu)“ 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 bisherigen APIs „Autocomplete“ und „Query Autocomplete“, die für „Autocomplete (New)“ umbenannt oder geändert wurden, sowie Parameter aufgeführt, 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
In der folgenden Beispiel-GET-Anfrage wird „Place Autocomplete (Legacy)“ verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu Orten an, die „Amoeba“ heißen und vom Typ establishment sind. Dabei übergeben Sie 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 '
Bei „Autocomplete (New)“ stellen Sie eine POST-Anfrage und übergeben 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. In der folgenden Anfrage wird beispielsweise eine Feldmaske verwendet, sodass die Antwort nur die suggestions.placePrediction.text des Vorschlags 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 ' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete
Weitere Informationen zur Verwendung von Feldmasken finden Sie unter Details zu Orten (neu).