Sobald Sie eine Orts-ID haben, können Sie weitere Details zu einer bestimmten Einrichtung oder einem POI anfordern, indem Sie eine „Place Details (New)“-Anfrage initiieren. Bei „Place Details (New)“-Anfragen werden umfassendere Informationen zum angegebenen Ort zurückgegeben, z. B. die vollständige Adresse, Telefonnummer, Nutzerbewertungen und Rezensionen.
Es gibt viele 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, damit Sie sich mit der API und den API-Optionen vertraut machen können:
Testen!„Place Details (New)“-Anfragen
Eine „Place Details“-Anfrage ist eine HTTP GET-Anfrage im Format:
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. Erstellen Sie dazu eine Antwortfeldmaske. Übergeben Sie die Antwortfeldmaske an die Methode. Verwenden Sie dazu den URL-Parameter
$fields
oderfields
oder den HTTP-HeaderX-Goog-FieldMask
. Die Antwort enthält keine Standardliste mit zurückgegebenen Feldern. Wenn Sie die Feldmaske weglassen, gibt die Methode einen Fehler zurück.Die Maskierung von Feldern hat sich bewährt, um sicherzustellen, dass keine unnötigen Daten angefordert werden. So lassen sich unnötige Verarbeitungszeiten und Gebühren vermeiden.
Geben Sie eine durch Kommas getrennte Liste der Ortsdatentypen an, die zurückgegeben werden sollen. Beispielsweise können Sie den Anzeigenamen und die Adresse des Orts abrufen.
X-Goog-FieldMask: displayName,formattedAddress
Verwenden Sie
*
, um alle Felder abzurufen.X-Goog-FieldMask: *
Geben Sie eines oder mehrere der folgenden Felder an:
Die folgenden Felder lösen die SKU „Place Details (IDs Only)“ aus:
attributions
,id
,name
*,photos
* Das Feldname
enthält den Ressourcennamen im Formatplaces/PLACE_ID
. Verwenden SiedisplayName
, um auf den Textnamen des Orts zuzugreifen.Die folgenden Felder lösen die SKU „Place Details (Location Only)“ aus:
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
Die folgenden Felder lösen die SKU Place Details (Basic) aus:
accessibilityOptions
,businessStatus
,displayName
,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,subDestinations
,utcOffsetMinutes
Die folgenden Felder lösen die SKU Place Details (Advanced) aus:
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
Die folgenden Felder lösen die SKU Place Details (Preferred) aus:
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
,reviews
,servesBeer
, {2/3/1}/servesBrunch
servesBreakfast
servesCocktails
servesCoffee
servesDessert
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 finden Sie unter Orts-IDs.
Der String
places/PLACE_ID
wird auch als Ressourcenname des Orts bezeichnet. In der Antwort auf Anfragen vom Typ „Place Details (New)“, „Nearby Search (New)“ und „Text Search (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. Google aktualisiert die unterstützten Sprachen häufig. Daher ist diese Liste möglicherweise nicht vollständig.
-
Wenn
languageCode
nicht angegeben ist, wird standardmäßigen
verwendet. 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 Nutzer als auch für Ortsansässige lesbar ist. Dazu werden Adressen in der lokalen Sprache zurückgegeben und bei Bedarf unter Berücksichtigung der bevorzugten Sprache in ein für den Nutzer lesbares Skript transliteriert. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Alle Adresskomponenten werden in derselben Sprache zurückgegeben, die aus der ersten Komponente ausgewählt wird.
- Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API die am besten passende Übereinstimmung.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Ergebnisse, die von der API zurückgegeben werden, und auf 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 möglicherweise in einer Sprache gültig sind, in einer anderen jedoch nicht.
regionCode
Der zum Formatieren der Antwort verwendete Regionscode, angegeben als zweistelliger CLDR-Code. Es gibt keinen Standardwert.
Wenn der Ländername des Felds
formattedAddress
in der Antwort mitregionCode
übereinstimmt, wird der Ländercode informattedAddress
weggelassen. Dieser Parameter hat keine Auswirkungen aufadrFormatAddress
, das immer den Ländernamen enthält, oder aufshortFormattedAddress
, der ihn nie enthält.Die meisten CLDR-Codes entsprechen den ISO 3166-1-Codes, mit einigen Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk) und der ISO 3166-1-Code „gb“ (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Northern Ireland“). Der Parameter kann sich gemäß geltendem Recht auf Ergebnisse auswirken.
-
sessionToken
Sitzungstokens sind vom Nutzer erstellte Strings, die Aufrufe der automatischen Vervollständigung (Neu) als „Sitzungen“ erfassen. Bei „Autocomplete (New)“ werden Sitzungstokens verwendet, um die Abfrage- und Auswahlphasen einer Nutzersuche mit automatischer Vervollständigung zu Abrechnungszwecken in einer separaten Sitzung zu gruppieren. Sitzungstokens werden an „Place Details (New)“-Aufrufe übergeben, die auf „Autocomplete (New)“-Aufrufe folgen. Weitere Informationen finden Sie unter Sitzungstokens.
Beispiel für „Place Details“
Im folgenden Beispiel werden die Details eines Ortes über 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 den 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 nun 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
auf:places/PLACE_ID
- Erweitern Sie optional Standardparameter anzeigen und legen Sie den Parameter
fields
auf 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.
Klicken Sie im Bereich „API Explorer“ auf das Symbol zum Maximieren (), um das API Explorer-Fenster zu maximieren.