Einführung
Die Places API unterstützt die APIs Place Autocomplete (Legacy) und Query Autocomplete (Legacy). Wenn Sie mit diesen APIs vertraut sind, werden durch Autocomplete (New) die folgenden Änderungen vorgenommen:
- Für Autocomplete (New) werden HTTP-POST-Anfragen verwendet. Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage übergeben. Bei den alten APIs werden URL-Parameter dagegen mit einer HTTP-GET-Anfrage übergeben.
- Für Autocomplete (New) werden sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus unterstützt.
- Bei Autocomplete (New) wird nur JSON als Antwortformat unterstützt.
In der folgenden Tabelle sind Parameter in Place Autocomplete (Legacy) und Query Autocomplete (Legacy) aufgeführt, die für Autocomplete (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 IP-Biasing. |
|
offset |
inputOffset |
|
radius |
locationBias oder locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Beispielanfrage
Im folgenden Beispiel für eine GET-Anfrage wird Place Autocomplete (Legacy) verwendet. 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'
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 Autocomplete (New)-Anfragen nicht erforderlich, können aber verwendet werden, um die Antwort nach bestimmten Ergebnissen zu filtern. Im folgenden Beispiel wird 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 Place Details (New).