Sobald Sie eine Orts-ID haben, können Sie weitere Details zu einer bestimmten Einrichtung oder indem Sie eine Place Details (neu) A Place Details (Neu) -Anforderung gibt umfassendere Informationen zum angegebenen Ort zurück. etwa 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 (neu)
- 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:
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 des 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 eine <ph type="x-smartling-placeholder"></ph> JSON-Objekt als Antwort an. In der Antwort:
- Die Antwort wird durch eine
Place
-Objekt enthält. Das ObjektPlace
enthält detaillierte Informationen zum - Die in der Anfrage übergebene FieldMask gibt die Liste der Felder an.
wird im
Place
-Objekt zurückgegeben.
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 ein Antwortfeldmaske. Übergeben Sie die Antwortfeldmaske mithilfe des URL-Parameters an die Methode.
$fields
oderfields
oder mithilfe des HTTP-HeadersX-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 ist sinnvoll, um unnötige Daten zu verarbeiten, um unnötige Verarbeitungszeiten zu vermeiden Abrechnungsgebühren.
Geben Sie eine durch Kommas getrennte Liste der Ortsdatentypen an, die zurückgegeben werden sollen. Beispiel: um den Anzeigenamen und die Adresse des Orts abzurufen.
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 des Orts. 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
,servesBreakfast
,servesBrunch
,servesCocktails
,servesCoffee
,servesDessert
,servesDinner
,servesLunch
,servesVegetarianFood
,servesWine
,takeout
-
placeId
Eine ID in Textform, die einen Ort eindeutig identifiziert. Sie wird von einem Text Search (New) oder Nearby Search (Neu). Weitere Informationen zu Orts-IDs finden Sie in der Orts-ID-Übersicht.
Der String
places/PLACE_ID
wird auch als Ort bezeichnet. Ressourcenname. In der Antwort von „Place Details (New)“ Nearby Search (New) und Text Search (New) angegeben ist, ist dieser String im Feldname
der Antwort enthalten. Die eigenständige Version Die Orts-ID ist im Feldid
der Antwort enthalten.
Optionale Parameter
languageCode
Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.
- Weitere Informationen finden Sie in der Liste der unterstützten Sprachen. Google aktualisiert häufig unterstützten Sprachen, 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 möglichst, eine Adresse bereitzustellen, die für sowohl für Nutzer als auch für Ortsansässige. Um dieses Ziel zu erreichen, gibt er Adressen in der Landessprache, in ein Skript umgewandelt, das von wenn nötig, unter Berücksichtigung der bevorzugten Sprache. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten sind alle in derselben Sprache zurückgegeben, die aus der ersten Komponente.
- Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API den am genauesten übereinstimmen.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Suchergebnisse, und in welcher Reihenfolge sie zurückgegeben werden. Die Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, etwa die Abkürzungen für Straßentypen oder Synonyme, die möglicherweise in einer Sprache gültig sind, aber nicht in einer anderen.
regionCode
Der Regionscode, der zum Formatieren der Antwort verwendet wird, angegeben als <ph type="x-smartling-placeholder"></ph> zweistelligen CLDR-Code eingeben. Es gibt keinen Standardwert.
Wenn der Ländername des Felds
formattedAddress
in der Antwort mit demregionCode
wird der Ländercode beiformattedAddress
weggelassen. Dieser Parameter hat keine Auswirkungen aufadrFormatAddress
. Dazu gehören immer das Land Name oder aufshortFormattedAddress
, wo ihn nie enthalten ist.Die meisten CLDR-Codes entsprechen den ISO 3166-1-Codes, mit einigen nennenswerten 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 des Vereinigten Königreichs Großbritannien und Nordirland“). Der Parameter kann sich gemäß geltendem Recht auf Ergebnisse auswirken.
-
sessionToken
Sitzungstokens sind vom Nutzer erstellte Strings, die die automatische Vervollständigung erfassen (Neu) Aufrufe als „Sitzungen“. Bei Autocomplete (New) werden Sitzungstokens verwendet, um Die Phasen „Abfrage“ und „Ortsauswahl“ einer Suche mit automatischer Vervollständigung durch Nutzer in einer separaten Sitzung gruppieren zu Abrechnungszwecken. Sitzungstokens werden an „Place Details (New)“ übergeben Aufrufe, die auf „Autocomplete“-Aufrufe („Neu“) folgen. Weitere Informationen finden Sie unter Sitzungstokens
Beispiel für „Place Details“
Im folgenden Beispiel werden die Details eines Ortes
placeId
:
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 X-Goog-FieldMask
-Header gibt an, dass die
Antwort
enthält die folgenden Datenfelder: 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 den Parameter
und Plus Code in das Feld
Antwort:
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" } }
Testen!
Mit dem API Explorer können Sie Beispielanfragen stellen, damit Sie sich mit der API und den API-Optionen vertraut machen können.
So stellen Sie eine Anfrage:
- Klicken Sie auf das API-Symbol
. rechts auf der Seite.
- Optional können Sie den Parameter
name
auf Folgendes festlegen:places/PLACE_ID
- Erweitern Sie optional Standardparameter anzeigen und legen Sie
Parameter
fields
zur Feldmaske hinzu. - Klicken Sie auf die Schaltfläche Execute (Ausführen). Wählen Sie im Pop-up-Fenster das Konto aus, verwenden, um die Anfrage zu stellen.
Klicken Sie im API Explorer auf das Symbol zum Maximieren
, um das API Explorer-Fenster zu maximieren.