Mając identyfikator miejsca, możesz uzyskać więcej informacji na temat określonej placówki lub ciekawe miejsce, inicjując Szczegóły miejsca (nowe) użytkownika. Szczegóły miejsca (nowe) żądanie zwraca bardziej szczegółowe informacje o wskazanym miejscu 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 Opcje interfejsu API:
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 jako część parametru Żądanie 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
Place
obiektu. ObiektPlace
zawiera szczegółowe informacje o miejsce. - FieldMask przekazana w żądaniu określa listę pól
zwracaną 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 za pomocą 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.Dobrą metodą projektowania jest maskowanie pól, dzięki którym zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania opłaty rozliczeniowe.
Podaj oddzieloną przecinkami listę typów danych miejsc do zwrócenia. Przykład: aby pobrać wyświetlaną nazwę i adres 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żyj formatu:displayName
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
,servesBeer
,servesBreakfast
,servesBrunch
,servesCocktails
,servesCoffee
,servesDessert
,servesDinner
,servesLunch
,servesVegetarianFood
,servesWine
,takeout
-
placeId
identyfikator tekstowy, który jednoznacznie identyfikuje miejsce, zwrócony z Wyszukiwanie tekstowe (nowe) lub Wyszukiwanie w pobliżu (nowość). Więcej informacji o identyfikatorach miejsc znajdziesz tutaj: omówienie identyfikatora miejsca.
Ciąg
places/PLACE_ID
jest również nazywany miejscem nazwa zasobu. W odpowiedzi ze szczegółów miejsca (nowość) Wyszukiwanie w pobliżu (nowość) i wyszukiwanie tekstowe (nowość) , ten ciąg będzie zawarty w poluname
odpowiedzi. Wersja samodzielna identyfikator miejsca znajduje się 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 informacje obsługiwanych języków, więc ta lista może nie być wyczerpująca.
-
Jeśli nie podano
languageCode
, domyślną wartością interfejsu API jesten
. Jeśli jeśli określisz nieprawidłowy kod języka, API zwróci błądINVALID_ARGUMENT
. - Robimy wszystko, co w naszej mocy, aby podać adres, który będzie czytelny dla zarówno użytkownika, jak i lokalnego użytkownika. Aby osiągnąć ten cel, adresów w języku lokalnym, transliterowanych na zapis czytelny dla w razie potrzeby, obserwując preferowany język. Wszystkie pozostałe są zwracane w preferowanym języku. Komponenty adresu są wszystkie zwrócone w tym samym języku, który jest wybierany spośród pierwszych .
- Jeśli nazwa nie jest dostępna w preferowanym języku, interfejs API używa atrybutu jak najbardziej zbliżona do siebie.
- Preferowany język ma niewielki wpływ na zestaw wyników, które zwracany przez interfejs API i kolejność ich zwrócenia. geokoder różnie interpretuje skróty w zależności od języka, np. skrótów typów ulic lub synonimów, które mogą być mogą być prawidłowe w jednym języku, a w innym już nie.
regionCode
Kod regionu używany do formatowania odpowiedzi podany jako dwuznakową wartość kodu CLDR. Nie ma wartości domyślnej.
Jeśli nazwa kraju w polu
formattedAddress
w odpowiedzi jest zgodna z nazwą krajuregionCode
, kod kraju został pominięty w poluformattedAddress
. Ten parametr nie ma wpływu na tabelęadrFormatAddress
, która zawsze obejmuje kraj lub w domenieshortFormattedAddress
, która nigdy jej nie zawiera.Większość kodów CLDR jest identyczna z kodami ISO 3166-1. z kilkoma istotnymi wyjątkami. Na przykład domena ccTLD Wielkiej Brytanii to „uk” (co.uk), natomiast kod ISO 3166-1 to „gb”. (technicznie dla funkcji podmiotu „Wielkiej Brytanii i Irlandii Północnej”). Ten parametr może wpływać na wyniki w zależności od obowiązującego prawa.
-
sessionToken
Tokeny sesji to generowane przez użytkownika ciągi znaków, które śledzą autouzupełnianie (Nowe) jako „sesje”. Autouzupełnianie (nowość) korzysta z tokenów sesji do Pogrupować zapytanie i umieścić etapy wyboru wyszukiwania autouzupełniania w oddzielnej sesji do celów rozliczeniowych. Tokeny sesji są przekazywane do szczegółów miejsca (nowe) połączeń, które są następstwem nowych połączeń autouzupełniania. Więcej informacji: Tokeny sesji.
Przykład strony Szczegóły miejsca
W poniższym przykładzie należy przesłać żądanie 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 parametr
odpowiedź
zawiera następujące 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ć
i Plus Code na stronie
odpowiedź:
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 wysyłanie przykładowych żądań, aby zapoznać się z interfejsem API i jego opcjami.
Aby wysłać prośbę:
- Kliknij ikonę interfejsu API
. w prawej części strony.
- Opcjonalnie ustaw parametr
name
na:places/PLACE_ID
- Opcjonalnie rozwiń opcję Pokaż parametry standardowe i ustaw
parametr
fields
do maski pola. - Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, którego chcesz użyć. których użyć do przesłania żądania.
W panelu Eksplorator API kliknij ikonę rozwijania.
, aby rozwinąć okno Eksploratora interfejsów API.