Places API unterstützt die bestehende Nearby Search. Wenn Sie mit der bestehenden Nearby Search-Funktion vertraut sind, neue Version von Nearby Search nimmt folgende Änderungen vor:
- Das neue Nearby Search verwendet HTTP-POST-Anfragen. Parameter im Anfragetext oder in Headern als Teil eines HTTP-POST übergeben Im Gegensatz zur bestehenden Nearby Search-Funktion können Sie URL-Parameter mit einer HTTP-GET-Anfrage übergeben.
- Die Maskierung von Feldern ist erforderlich. Sie müssen angeben, welche Felder zurückgegeben werden sollen in der Antwort angeben. Es gibt keine Standardliste der zurückgegebenen Felder. Wenn Sie diese Liste enthält, geben die Methoden einen Fehler zurück. Weitere Informationen finden Sie unter FieldMask.
- Das neue Nearby Search unterstützt sowohl API-Schlüssel und OAuth als Authentifizierungsmechanismus.
- In der neuen Version wird nur JSON als Antwortformat unterstützt. Nearby Search aus.
- Für alle Anfragen, die eine Textabfrage enthalten, sollte nun Textsuche (neu) da „Nearby Search (New)“ die Texteingabe nicht unterstützt.
- Das JSON-Antwortformat für Nearby Search (New) Das Format der vorhandenen APIs hat sich geändert. Weitere Informationen finden Sie unter Migrieren Sie die Places API-Antwort.
In der folgenden Tabelle sind die Parameter der vorhandenen Nearby Search, die für die neuen Nearby Search-Parametern oder Parameter, die nicht mehr unterstützt.
| Aktueller Parameter | Neuer Parameter | Hinweise |
|---|---|---|
keyword |
Nicht unterstützt. Verwenden Sie Textsuche (neu) . | |
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. Vorhandene API akzeptiert nur einen einzelnen Wert. |
Beispielanfrage
Im folgenden Beispiel für eine GET-Anfrage wird die vorhandene
Nearby Search aus. In diesem Beispiel fordern Sie eine JSON-Datei an,
Antwort mit Informationen zu Orten des Typs restaurant 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 Sie 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 das Feld Anzeigename und formatierte Adresse des Orts:
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