Einführung
Die Places API unterstützt „Place Details (Legacy)“. Wenn Sie mit der Places API (Legacy) vertraut sind, werden mit „Place Details (New)“ die folgenden Änderungen eingeführt:
- 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.
- „Place Details (New)“ unterstützt sowohl API-Schlüssel als auch OAuth -Tokens als Authentifizierungsmechanismus.
- Als Antwortformat wird in „Place Details (New)“ nur JSON unterstützt.
- Das JSON-Antwortformat für die Places API (New) hat sich gegenüber dem Format der Legacy-APIs geändert. Weitere Informationen finden Sie unter Migrieren der Places API-Antwort.
In der folgenden Tabelle sind Parameter in „Place Details (Legacy)“ aufgeführt, die für „Place Details (New)“ 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 der
OrtsRessourcenname bezeichnet. In der Antwort auf eine Anfrage von „Place Details (New)“,
„Nearby Search (New)“ und „Text Search (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-Anfrage wird „Place Details (Legacy)“ 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'
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 Anfrage von „Place Details (New)“, „Nearby Search (New)“ und „Text Search (New)“ ist dieser String im Feld name der Antwort enthalten. Die eigenständige Orts-ID ist im Feld id der Antwort enthalten.