Einführung
Die Places API unterstützt die APIs „Place Autocomplete (Legacy)“ und „Query Autocomplete (Legacy)“. Wenn Sie mit diesen APIs vertraut sind, werden mit „Autocomplete (New)“ die folgenden Änderungen eingeführt:
- „Autocomplete (New)“ verwendet HTTP-POST-Anfragen. Parameter werden im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage übergeben. Bei den Legacy-APIs werden URL-Parameter dagegen mit einer HTTP-GET-Anfrage übergeben.
- „Autocomplete (New)“ unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
- Als Antwortformat wird in „Autocomplete (New)“ nur JSON unterstützt.
In der folgenden Tabelle sind Parameter in „Place Autocomplete (Legacy)“ und „Query Autocomplete (Legacy)“ 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-Biasierung. |
|
offset |
inputOffset |
|
radius |
locationBias oder locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Beispielanfrage
Die folgende GET-Beispielanfrage verwendet „Place Autocomplete (Legacy)“. 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 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. In der folgenden Anfrage wird beispielsweise eine Feldmaske verwendet, sodass die Antwort nur 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)“.