Die Places API unterstützt die vorhandenen Ortsdetails. Wenn Sie mit der bestehenden Places API vertraut sind, sind bei der neuen Version von Place Details die folgenden Änderungen zu beachten:
- 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 weglassen, 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 der API „Place Details (New)“ 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 Details zum Ort aufgeführt, die für die neuen Details zum Ort umbenannt oder geändert wurden, oder 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
Place Ressourcenname. In der Antwort einer „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 ist im Feld id der Antwort enthalten. |
language |
languageCode |
|
region |
regionCode |
Beispielanfrage
In der folgenden Beispiel-GET-Anfrage werden die vorhandenen Details zum Ort verwendet. 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 den
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. 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 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 befindet sich im Feld id der Antwort.