Die Places API unterstützt die vorhandenen Place Details-Anfragen. Wenn Sie mit der vorhandenen Places API vertraut sind, werden in der neuen Version von „Place Details“ die folgenden Änderungen vorgenommen:
- 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 auslassen, geben die Methoden einen Fehler zurück. Weitere Informationen findest du unter FieldMask.
- Das neue „Place Details“-Objekt unterstützt sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
- Im neuen „Place Details“-Objekt wird als Antwort nur JSON unterstützt.
- Das JSON-Antwortformat für die Place Details (New) API hat sich gegenüber dem Format der vorhandenen APIs geändert. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter in den vorhandenen „Place Details“-Anfragen aufgeführt, die für die neuen „Place Details“-Anfragen umbenannt oder geändert wurden, sowie Parameter, die nicht mehr unterstützt werden.
Aktueller Parameter | Neuer Parameter | Hinweise |
---|---|---|
place_id |
places/PLACE_ID |
Der String places/PLACE_ID wird auch als Ressourcenname des Orts bezeichnet. In der Antwort einer „Place Details (New)“-, „Nearby Search (New)“- und einer Text Search-Anfrage (New) 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
In der folgenden GET-Beispielanfrage werden die vorhandenen „Place Details“-Anfragen verwendet. In diesem Beispiel fordern Sie eine JSON-Antwort mit Informationen zu einer Orts-ID an und übergeben alle Parameter als URL-Parameter. In diesem Beispiel wird auch fields
verwendet, sodass die Antwort nur den Anzeigenamen und die formatierte Adresse des Orts enthält:
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 übergeben dabei alle Parameter in URL-Parametern und Headern. In diesem Beispiel wird auch eine Feldmaske verwendet, sodass die Antwort nur den Anzeigenamen und die formatierte Adresse des Orts enthält:
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 Ressourcenname des Orts bezeichnet. In der Antwort einer „Place Details (New)“-, „Nearby Search (New)“- und einer Text Search-Anfrage (New) ist dieser String im Feld name
der Antwort enthalten. Die eigenständige Orts-ID ist im Feld id
der Antwort enthalten.