Sobald Sie eine Orts-ID haben, können Sie eine „Place Details (neu)“-Anfrage senden, um weitere Details zu einer bestimmten Einrichtung oder einem POI anzufordern. Eine „Place Details (New)“-Anfrage gibt umfassendere Informationen zum angegebenen Ort zurück, z. B. die vollständige Adresse, Telefonnummer, Nutzerbewertung und Rezensionen.
Es gibt verschiedene Möglichkeiten, eine Orts-ID zu erhalten. Sie können Folgendes angeben:
- Text Search (New) oder Nearby Search (New)
- Geocoding API
- Routes API
- Address Validation API
- Place Autocomplete
Mit dem API Explorer können Sie Live-Anfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:
Testen!„Place Details (New)“-Anfragen
Eine „Place Details“-Anfrage ist eine HTTP GET-Anfrage in der Form:
https://places.googleapis.com/v1/places/PLACE_ID
Übergeben Sie alle Parameter als URL-Parameter oder in Headern als Teil der GET-Anfrage. Beispiel:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
Oder in einem cURL-Befehl:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
„Place Details (New)“-Antworten
„Place Details (New)“ gibt ein JSON-Objekt als Antwort zurück. In der Antwort:
- Die Antwort wird durch ein
Place
-Objekt dargestellt. Das ObjektPlace
enthält detaillierte Informationen zum Ort. - Die in der Anfrage übergebene FieldMask gibt die Liste der Felder an, die im Objekt
Place
zurückgegeben werden.
Das vollständige JSON-Objekt hat das folgende Format:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
Erforderliche Parameter
-
FieldMask
Geben Sie die Liste der Felder an, die in der Antwort zurückgegeben werden sollen, indem Sie eine Antwortfeldmaske erstellen. Übergeben Sie die Antwortfeldmaske mit dem URL-Parameter
$fields
oderfields
oder mit dem HTTP-HeaderX-Goog-FieldMask
an die Methode. Die Antwort enthält keine Standardliste der zurückgegebenen Felder. Wenn Sie die Feldmaske weglassen, gibt die Methode einen Fehler zurück.Die Maskierung von Feldern hat sich bewährt, damit keine unnötigen Daten angefordert werden. So lassen sich unnötige Verarbeitungszeiten und Gebühren vermeiden.
Geben Sie eine durch Kommas getrennte Liste von Ortsdatentypen an, die zurückgegeben werden sollen. Beispiel: Der Anzeigename und die Adresse des Orts werden abgerufen.
X-Goog-FieldMask: displayName,formattedAddress
Verwenden Sie
*
, um alle Felder abzurufen.X-Goog-FieldMask: *
Geben Sie eines oder mehrere der folgenden Felder an:
Durch die folgenden Felder wird die SKU „Place Details (IDs Only)“ ausgelöst:
id
,name
*,photos
* Das Feldname
enthält den Ressourcennamen des Orts in folgendem Format:places/PLACE_ID
. Verwenden SiedisplayName
, um auf den Textnamen des Orts zuzugreifen.Durch die folgenden Felder wird die SKU Place Details (Location Only) ausgelöst:
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
Durch die folgenden Felder wird die SKU Place Details (Basic) ausgelöst:
accessibilityOptions
,businessStatus
,displayName
,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,subDestinations
,utcOffsetMinutes
Durch die folgenden Felder wird die SKU Place Details (Advanced) ausgelöst:
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
Durch die folgenden Felder wird die SKU Place Details (Preferred) ausgelöst:
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
, {1/7/}, {2/7, {2/7/}, {2/7, {2/7/}, {2/7, {2/7/}, {2/7/}, {2/7,{2/7,{2/2/2,2/2},menuForChildren
,menuForChildren
,parkingOptions
,menuForChildren
,parkingOptions
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDesserts
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
-
placeId
Eine Kennung in Textform, die einen Ort eindeutig identifiziert und von Text Search (New) oder Nearby Search (New) zurückgegeben wird. Weitere Informationen zu Orts-IDs finden Sie in der Übersicht zu Orts-IDs.
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 Feldname
der Antwort enthalten. Die eigenständige Orts-ID ist im Feldid
der Antwort enthalten.
Optionale Parameter
languageCode
Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.
- Hier finden Sie eine Liste der unterstützten Sprachen. Die unterstützten Sprachen werden von Google häufig aktualisiert. Daher ist diese Liste unter Umständen nicht vollständig.
-
Wenn
languageCode
nicht angegeben ist, wird die API standardmäßig aufen
gesetzt. Wenn Sie einen ungültigen Sprachcode angeben, gibt die API den FehlerINVALID_ARGUMENT
zurück. - Die API versucht, eine Adresse anzugeben, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Adressen in der lokalen Sprache zurückgegeben und bei Bedarf in ein für den Nutzer lesbares Skript transkribiert. Dabei wird die bevorzugte Sprache berücksichtigt. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Alle Adresskomponenten werden in derselben Sprache zurückgegeben, die in der ersten Komponente ausgewählt wird.
- Wenn ein Name nicht in der bevorzugten Sprache verfügbar ist, verwendet die API die beste Übereinstimmung.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Ergebnisse, die von der API zurückgegeben werden, sowie die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sein können, in einer anderen jedoch nicht.
regionCode
Der zum Formatieren der Antwort verwendete Regionscode, angegeben als zweistelliger CLDR-Code-Wert. Es gibt keinen Standardwert.
Wenn der Ländername des Felds
formattedAddress
in der Antwort mitregionCode
übereinstimmt, wird der Ländercode beiformattedAddress
weggelassen. Dieser Parameter hat keine Auswirkungen aufadrFormatAddress
, das immer den Ländernamen enthält, oder aufshortFormattedAddress
, das ihn nie enthält.Die meisten CLDR-Codes sind mit ISO 3166-1-Codes identisch. Es gibt jedoch einige Ausnahmen. Die ccTLD des Vereinigten Königreichs lautet beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Northern Ireland“). Der Parameter kann sich gemäß anwendbarem Recht auf Ergebnisse auswirken.
-
sessionToken
Sitzungstokens sind vom Nutzer generierte Strings, die Aufrufe der automatischen Vervollständigung (New) als „Sitzungen“ erfassen. Die Funktion „Autocomplete (neu)“ verwendet Sitzungstokens, um die Abfrage zu gruppieren und die Auswahlphasen einer Suche mit automatischer Vervollständigung durch den Nutzer zu Abrechnungszwecken in eine separate Sitzung zu verschieben. Sitzungstokens werden an „Place Details (New)“-Aufrufe übergeben, die auf „Autocomplete (New)“-Aufrufe folgen. Weitere Informationen finden Sie unter Sitzungstokens.
Beispiel für eine „Place Details“-Anfrage
Im folgenden Beispiel werden die Details eines Orts mit placeId
angefordert:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Der Header X-Goog-FieldMask
gibt an, dass die Antwort die folgenden Datenfelder enthält: id,displayName
.
Die Antwort hat dann folgendes Format:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
Fügen Sie der Feldmaske weitere Datentypen hinzu, um zusätzliche Informationen zurückzugeben.
Fügen Sie beispielsweise formattedAddress,plusCode
hinzu, um die Adresse und Plus Code in die Antwort aufzunehmen:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Die Antwort hat jetzt das folgende Format:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
Jetzt testen
Mit dem API Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.
So stellen Sie eine Anfrage:
- Wählen Sie rechts auf der Seite das API-Symbol aus.
- Legen Sie optional den Parameter
name
fest auf:places/PLACE_ID
- Maximieren Sie optional Standardparameter anzeigen und legen Sie für den Parameter
fields
die Feldmaske fest. - Klicken Sie auf die Schaltfläche Execute (Ausführen). Wählen Sie im Pop-up-Fenster das Konto aus, das Sie für die Anfrage verwenden möchten.
Wählen Sie im API Explorer-Bereich das Symbol zum Maximieren aus, um das Fenster „API Explorer“ zu maximieren.