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.