Die Places API unterstützt die vorhandenen Ortsdetails. Wenn Sie mit der bestehenden Places API vertraut sind, sind in der neuen Version von „Ortsdetails“ die folgenden Änderungen zu beachten:
- 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 neuen „Place Details“ unterstützen sowohl API-Schlüssel als auch OAuth als Authentifizierungsmechanismus.
- In den neuen Details zu Orten wird nur JSON als Antwortformat unterstützt.
- Das JSON-Antwortformat der Place Details (New) API unterscheidet sich vom Format der vorhandenen APIs. Weitere Informationen finden Sie unter Places API-Antwort migrieren.
In der folgenden Tabelle sind Parameter in den vorhandenen „Place Details“, die für die neuen „Place Details“ umbenannt oder geändert wurden, sowie Parameter aufgeführt, 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 auf eine Anfrage vom Typ „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ ist dieser String im Feld name enthalten.
Die eigenständige Orts-ID ist im Feld id der Antwort enthalten. |
language |
languageCode |
|
region |
regionCode |
Beispielanfrage
In der folgenden Beispiel-GET-Anfrage werden die vorhandenen „Place Details“ verwendet. In diesem Beispiel wird eine JSON-Antwort mit Informationen zu einer Orts-ID angefordert und alle Parameter werden als URL-Parameter übergeben. 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'
Bei „Place Details (New)“ stellen Sie eine GET-Anfrage und übergeben alle Parameter in URL-Parametern und Headern als Teil der Anfrage. 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 auf eine „Place Details (New)“-, „Nearby Search (New)“- und „Text Search (New)“-Anfrage ist dieser String im Feld name der Antwort enthalten. Die eigenständige Orts-ID befindet sich im Feld id der Antwort.