Die Places API unterstützt die vorhandene Nearby Search. Wenn Sie mit der vorhandenen Nearby Search-Version vertraut sind, werden in der neuen Version von Nearby Search die folgenden Änderungen vorgenommen:
- Das neue Nearby Search verwendet HTTP POST-Anfragen. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Im Gegensatz dazu übergeben Sie URL-Parameter bei der vorhandenen „Nearby Search“-Anfrage über eine HTTP-GET-Anfrage.
- Maskierung von Feldern 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 auslassen, geben die Methoden einen Fehler zurück. Weitere Informationen findest du unter FieldMask.
- Das neue Nearby Search unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
- Im neuen Nearby Search wird als Antwortformat nur JSON 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 (New) API hat sich gegenüber dem Format der vorhandenen APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter der vorhandenen Nearby Search, die für die neue Nearby Search umbenannt oder geändert wurden, oder Parameter aufgeführt, 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 |
|
locationRestriction jetzt verwenden. |
rankby |
rankPreference |
|
regionCode |
Neuer Parameter. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Die neuen Parameter akzeptieren auch mehrere Typwerte. Die vorhandene API akzeptiert nur einen einzelnen Wert. |
Beispielanfrage
In der folgenden GET-Beispielanfrage wird die vorhandene „Nearby Search“-Anfrage 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'
Mit „Nearby Search (New)“ stellen Sie eine POST-Anfrage und übergeben dabei 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