Zu „Place Details“ migrieren (Neu)

Places API unterstützt die bestehende Place Details (Ortsdetails): Wenn Sie mit der bestehenden Places API vertraut sind, ist die neue Version von Place Details nimmt folgende Änderungen vor:

  • 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.
  • Die neue Place Details-Version unterstützt sowohl API-Schlüssel und OAuth als Authentifizierungsmechanismus.
  • In der neuen Version wird nur JSON als Antwortformat unterstützt. Place Details.
  • Das JSON-Antwortformat für „Place Details (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 Ortsdetails, die umbenannt oder geändert wurden für die neuen „Place Details“-Anfragen oder Parameter, die nicht mehr unterstützt.

Aktueller Parameter Neuer Parameter Hinweise
place_id places/PLACE_ID Der String places/PLACE_ID wird auch als Place Ressourcenname. In der Antwort von „Place Details (New)“ Nearby Search (New) und Text Search (New) angegeben ist, ist dieser String im Feld name der Antwort enthalten. Die eigenständige Orts-ID ist im Feld id der Antwort enthalten.
language languageCode
region regionCode

Beispielanfrage

Im folgenden Beispiel für eine GET-Anfrage wird die vorhandene Place Details. In diesem Beispiel fordern Sie eine JSON-Datei an, Antwort, die Informationen zu einer Orts-ID enthält und alle Parameter als URL übergibt Parameter. In diesem Beispiel wird auch fields verwendet, sodass die Antwort nur das Feld Anzeigename und formatierte Adresse des Orts:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'

Mit „Place Details (New)“ stellen Sie eine GET-Anfrage und alle Parameter in URL-Parametern und -Headern als Teil der Anfrage übergeben. Dieses In diesem Beispiel wird auch eine Feldmaske verwendet, sodass die Antwort nur den Anzeigenamen enthält. und die formatierte Adresse des Orts:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,formattedAddress" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Der String places/PLACE_ID wird auch als Ort bezeichnet. Ressourcenname. In der Antwort auf eine „Place Details“-Anfrage (New), Nearby Search (New) und „Text Search (New)“-Anfrage, diese Zeichenfolge ist in Das Feld name der Antwort. Die eigenständige Orts-ID ist im id der Antwort.