Zu Nearby Search migrieren (Neu)

Entwickler im Europäischen Wirtschaftsraum (EWR)

Einführung

Die Places API unterstützt Nearby Search (Legacy). Wenn Sie mit Nearby Search (Legacy) vertraut sind, werden mit Nearby Search (New) die folgenden Änderungen eingeführt:

  • Für die neue Nearby Search werden HTTP-POST-Anfragen verwendet. Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP-POST-Anfrage. Bei Nearby Search (Legacy) werden URL-Parameter dagegen mit einer HTTP-GET-Anfrage übergeben.
  • Die 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 weglassen, geben die Methoden einen Fehler zurück. Weitere Informationen finden Sie unter FieldMask.
  • Die Nearby Search (New) API unterstützt sowohl API-Schlüssel als auch OAuth-Tokens als Authentifizierungsmechanismus.
  • Nur JSON wird als Antwortformat in der neuen Nearby Search 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 Nearby Search (New) hat sich gegenüber dem Format der alten APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.

In der folgenden Tabelle sind Parameter in Nearby Search (Legacy) aufgeführt, die für Nearby Search (New) 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 Textsuche (Neu).
language languageCode
location locationRestriction Erforderlich.
maxprice/minprice Nicht unterstützt.
maxResultCount Neuer Parameter.
opennow Nicht unterstützt.
pagetoken Nicht unterstützt.
radius Jetzt locationRestriction nutzen
rankby rankPreference
regionCode Neuer Parameter.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		Die neuen Parameter akzeptieren auch mehrere Typwerte. Die Legacy-API akzeptiert nur einen einzelnen Wert.

Beispielanfrage

Im folgenden Beispiel für eine GET-Anfrage wird die Nearby Search (Legacy) verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu Orten des Typs 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, damit 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