Die Places API unterstützt die Nearby Search (alte Version). Wenn Sie die Nearby Search (alte Version) bereits kennen, sind die folgenden Änderungen bei der Nearby Search (neue Version) zu beachten:
- Die neue Nearby Search verwendet HTTP-POST-Anfragen. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Bei der bisherigen Nearby Search werden URL-Parameter dagegen mit einer HTTP-GET-Anfrage übergeben.
- Die Feldmaskierung ist erforderlich. Sie müssen angeben, welche Felder in der Antwort zurückgegeben werden sollen. Es gibt keine Standardliste der zurückgegebenen Felder. Wenn Sie diese Liste weglassen, geben die Methoden einen Fehler zurück. Weitere Informationen finden Sie unter FieldMask.
- Die Nearby Search (neu) unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
- In der Nearby Search (neu) wird nur JSON als Antwortformat unterstützt.
- Für alle Anfragen, die eine Textabfrage enthalten, sollte jetzt Text Search (New) verwendet werden, da Nearby Search (New) keine Texteingabe unterstützt.
- Das JSON-Antwortformat für die Nearby Search (neu) unterscheidet sich vom Format der bisherigen APIs. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter in der bisherigen Nearby Search aufgeführt, die für die neue Nearby Search umbenannt oder geändert wurden, oder Parameter, die nicht mehr unterstützt werden.
| Aktueller Parameter | Neuer Parameter | Hinweise |
|---|---|---|
keyword |
Nicht unterstützt. Verwenden Sie stattdessen Text Search (New). | |
language |
languageCode |
|
location |
locationRestriction |
Erforderlich. |
maxprice/minprice |
|
Nicht unterstützt. |
maxResultCount |
Neuer Parameter. | |
opennow |
|
Nicht unterstützt. |
pagetoken |
Nicht unterstützt. | |
radius |
|
Verwenden Sie jetzt locationRestriction. |
rankby |
rankPreference |
|
regionCode |
Neuer Parameter. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Die neuen Parameter akzeptieren auch mehrere Typwerte. Die alte API akzeptiert nur einen einzelnen Wert. |
Beispielanfrage
In der folgenden Beispiel-GET-Anfrage wird die Nearby Search (alte Version) verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu Orten vom Typ restaurant an und übergeben alle Parameter als URL-Parameter:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
Bei „Nearby Search (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 '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby