Zu Nearby Search migrieren (Neu)

Entwickler im Europäischen Wirtschaftsraum (EWR)

Einführung

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

  • Die Nearby Search (New) verwendet HTTP POST-Anfragen. Parameter werden im Anfragetext oder in Headern als Teil einer HTTP POST Anfrage übergeben. Bei der Nearby Search (Legacy) werden URL-Parameter dagegen mit einer HTTP GET-Anfrage übergeben.
  • 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 (New) unterstützt sowohl API-Schlüssel als auch OAuth Tokens als Authentifizierungsmechanismus.
  • Als Antwortformat wird in der Nearby Search (New) nur JSON unterstützt.
  • Für alle Anfragen mit einer Textabfrage sollte jetzt Text Search (New) verwendet werden, da die Nearby Search (New) keine Texteingabe unterstützt.
  • Das JSON-Antwortformat für die Nearby Search (New) hat sich vom Format der Legacy-APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.

In der folgenden Tabelle sind Parameter in der Nearby Search (Legacy) aufgeführt, die für die Nearby Search (New) umbenannt oder geändert wurden, sowie Parameter, die nicht mehr unterstützt werden.

Aktueller Parameter Neuer Parameter Hinweise
keyword Nicht unterstützt. Verwenden Sie Text Search (New) stattdessen.
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 includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		Die neuen Parameter akzeptieren auch mehrere Typwerte. Die Legacy-API akzeptiert nur einen einzelnen Wert.

Beispielanfrage

In der folgenden GET-Beispielanfrage 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 der 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 Ortes 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