Po uzyskaniu identyfikatora miejsca możesz poprosić o więcej informacji na temat konkretnego obiektu lub ciekawego miejsca, przesyłając prośbę o szczegóły miejsca (nowe). Żądanie szczegółów miejsca (nowe) zwraca bardziej szczegółowe informacje na temat wskazanego miejsca, takie jak pełny adres, numer telefonu, oceny i opinie użytkowników.
Identyfikator miejsca można uzyskać na wiele sposobów. Możesz użyć:
- Wyszukiwanie tekstowe (nowe) lub Wyszukiwanie w pobliżu (nowość)
- Geocoding API
- Interfejs Routes API
- Adres API weryfikacji adresów
- Autouzupełnianie miejsc
API Explorer umożliwia wysyłanie żądań na żywo, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami:
WypróbujProśby o szczegóły miejsca (nowe)
Żądanie dotyczące informacji o miejscu to żądanie HTTP GET mające postać:
https://places.googleapis.com/v1/places/PLACE_ID
Przekazuj wszystkie parametry jako parametry adresu URL lub w nagłówkach w ramach żądania GET. Na przykład:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY
Lub w poleceniu cURL:
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
Odpowiedzi na temat szczegółów miejsca (nowe)
Place Details (nowe) zwraca obiekt JSON jako odpowiedź. W odpowiedzi:
- Odpowiedź jest reprezentowana przez obiekt
Place
. ObiektPlace
zawiera szczegółowe informacje o miejscu. - FieldMask przekazana w żądaniu określa listę pól zwróconych w obiekcie
Place
.
Pełny obiekt JSON ma następujący format:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
Wymagane parametry
-
FieldMask
Określ listę pól, które mają być zwracane w odpowiedzi, tworząc maskę pola odpowiedzi. Przekaż maskę pola odpowiedzi do metody, używając parametru adresu URL
$fields
lubfields
albo nagłówka HTTPX-Goog-FieldMask
. Odpowiedź nie zawiera domyślnej listy zwróconych pól. Jeśli pominiesz maskę pola, metoda zwróci błąd.Maskowanie pól to sprawdzona metoda projektowania, która pozwala uniknąć żądania zbędnych danych. Pozwala to uniknąć niepotrzebnego czasu przetwarzania i opłat.
Podaj oddzieloną przecinkami listę typów danych miejsc do zwrócenia. Na przykład w celu pobrania wyświetlanej nazwy i adresu miejsca.
X-Goog-FieldMask: displayName,formattedAddress
Użyj
*
, aby pobrać wszystkie pola.X-Goog-FieldMask: *
Wypełnij co najmniej jedno z tych pól:
Te pola aktywują kod SKU szczegółów miejsca (tylko identyfikatory):
attributions
,id
,name
*,photos
* Polename
zawiera nazwę zasobu miejsca w formacie:places/PLACE_ID
.
UżyjdisplayName
, aby uzyskać dostęp do tekstowej nazwy miejsca.Te pola aktywują kod SKU szczegółów miejsca (tylko lokalizacja):
addressComponents
,adrFormatAddress
,formattedAddress
,location
,plusCode
,shortFormattedAddress
,types
,viewport
Te pola aktywują kod SKU informacji o miejscu (podstawowe):
accessibilityOptions
,businessStatus
,displayName
,googleMapsUri
,iconBackgroundColor
,iconMaskBaseUri
,primaryType
,primaryTypeDisplayName
,subDestinations
,utcOffsetMinutes
Te pola aktywują kod SKU szczegółów miejsca (zaawansowane):
currentOpeningHours
,currentSecondaryOpeningHours
,internationalPhoneNumber
,nationalPhoneNumber
,priceLevel
,rating
,regularOpeningHours
,regularSecondaryOpeningHours
,userRatingCount
,websiteUri
Te pola aktywują kod SKU szczegółów miejsca (preferowany):
allowsDogs
,curbsidePickup
,delivery
,dineIn
,editorialSummary
,evChargeOptions
,fuelOptions
,goodForChildren
,goodForGroups
,goodForWatchingSports
,liveMusic
,menuForChildren
,parkingOptions
,paymentOptions
,outdoorSeating
,reservable
,restroom
,reviews
, {//},servesBreakfast
,servesBreakfast
,servesBeer
, {19/servesBrunch
servesCocktails
servesCoffee
servesDesserts
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
-
placeId
Identyfikator tekstowy, który jednoznacznie identyfikuje miejsce, zwrócony z użyciem wyszukiwania tekstowego (nowego) lub wyszukiwania w pobliżu (nowego). Więcej informacji o identyfikatorach miejsc znajdziesz w artykule Omówienie identyfikatorów miejsc.
Ciąg znaków
places/PLACE_ID
jest również nazywany nazwą zasobu miejsca. W odpowiedzi na żądanie dotyczące informacji o miejscu (nowe), wyszukiwania w pobliżu (nowe) i wyszukiwania tekstowego (nowe) ten ciąg jest zawarty w poluname
tej odpowiedzi. Samodzielny identyfikator miejsca jest zawarty w poluid
odpowiedzi.
Parametry opcjonalne
languageCode
Język, w którym mają być zwracane wyniki.
- Zobacz listę obsługiwanych języków. Google często aktualizuje obsługiwane języki, więc ta lista może nie być wyczerpująca.
-
Jeśli nie podano
languageCode
, domyślną wartością interfejsu API jesten
. Jeśli podasz nieprawidłowy kod języka, interfejs API zwróci błądINVALID_ARGUMENT
. - Interfejs API stara się dostarczyć adres, który będzie czytelny zarówno dla użytkownika, jak i lokalnego użytkownika. Aby osiągnąć ten cel, zwraca adresy w języku lokalnym, transliterację na skrypt, który w razie potrzeby może odczytać użytkownik, z zachowaniem preferowanego języka. Pozostałe adresy są zwracane w preferowanym języku. Komponenty adresu są zwracane w tym samym języku, który jest wybierany z pierwszego komponentu.
- Jeśli nazwa nie jest dostępna w preferowanym języku, interfejs API używa najbliższego dopasowania.
- Preferowany język ma niewielki wpływ na zestaw wyników zwracanych przez interfejs API oraz na kolejność, w jakiej są one zwracane. Geokoder różnie interpretuje skróty w zależności od języka. Mogą to być np. skróty nazw typów ulic lub synonimy, które mogą być prawidłowe w jednym języku, a w innym nie.
regionCode
Kod regionu używany do formatowania odpowiedzi podany jako wartość dwuznakowego kodu CLDR. Nie ma wartości domyślnej.
Jeśli nazwa kraju w polu
formattedAddress
w odpowiedzi jest zgodna z nazwąregionCode
, kod kraju jest pomijany w poluformattedAddress
. Ten parametr nie ma wpływu na metodęadrFormatAddress
, która zawsze zawiera nazwę kraju, ani na obiektshortFormattedAddress
, który go nigdy nie zawiera.Większość kodów CLDR jest identyczna z kodami ISO 3166-1 z kilkoma wyjątkami. Na przykład domena ccTLD Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”). Ten parametr może wpływać na wyniki w zależności od obowiązującego prawa.
-
sessionToken
Tokeny sesji to ciągi wygenerowane przez użytkownika, które śledzą nowe (nowe) wywołania autouzupełniania jako „sesje”. Autouzupełnianie (nowość) korzysta z tokenów sesji do grupowania zapytania i umieszczania etapów wyboru wyszukiwania autouzupełniania użytkownika w oddzielnej sesji na potrzeby rozliczeń. Tokeny sesji są przekazywane do wywołań funkcji szczegółów miejsca (nowych) po wywołaniach autouzupełniania (nowych). Więcej informacji znajdziesz w artykule o tokenach sesji.
Przykład strony Szczegóły miejsca
Ten przykład wymaga podania szczegółowych informacji o miejscu przez 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
Zwróć uwagę, że nagłówek X-Goog-FieldMask
określa, że odpowiedź zawiera te pola danych: id,displayName
.
Odpowiedź ma postać:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
Aby zwracać dodatkowe informacje, dodaj do maski pola więcej typów danych.
Na przykład dodaj formattedAddress,plusCode
, aby uwzględnić adres i kod plus w odpowiedzi:
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
Odpowiedź ma teraz taki 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" } }
Wypróbuj
API Explorer umożliwia wykonywanie przykładowych żądań, aby zapoznać się z interfejsem API i jego opcjami.
Aby wysłać prośbę:
- Wybierz ikonę interfejsu API () po prawej stronie.
- Opcjonalnie ustaw parametr
name
na:places/PLACE_ID
- Opcjonalnie rozwiń sekcję Pokaż parametry standardowe i ustaw parametr
fields
na maskę pola. - Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, którego chcesz użyć do przesłania prośby.
W panelu API Explorer kliknij ikonę rozwijania , aby rozwinąć okno API Explorer.