Zu Nearby Search migrieren (Neu)

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 und Parametern, 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 includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
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