Szczegóły miejsca (nowość)

Wybierz platformę: Android iOS JavaScript Usługa internetowa

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ć:

API Explorer umożliwia wysyłanie żądań na żywo, dzięki czemu możesz zapoznać się z interfejsem API Opcje interfejsu API:

Wypróbuj

Proś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. Obiekt Place 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 lub fields albo za pomocą nagłówka HTTP X-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

      * Pole name 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 polu name odpowiedzi. Wersja samodzielna identyfikator miejsca znajduje się w polu id 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 jest en. Jeśli jeśli określisz nieprawidłowy kod języka, API zwróci błąd INVALID_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ą kraju regionCode, kod kraju został pominięty w polu formattedAddress. Ten parametr nie ma wpływu na tabelę adrFormatAddress, która zawsze obejmuje kraj lub w domenie shortFormattedAddress, 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ę:

  1. Kliknij ikonę interfejsu API Rozwiń interfejs API Explorer.. w prawej części strony.
  2. Opcjonalnie ustaw parametr name na: 
    places/PLACE_ID
  3. Opcjonalnie rozwiń opcję Pokaż parametry standardowe i ustaw parametr fields do maski pola.
  4. Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, którego chcesz użyć. których użyć do przesłania żądania.

  5. W panelu Eksplorator API kliknij ikonę rozwijania. Rozwiń interfejs API Explorer., aby rozwinąć okno Eksploratora interfejsów API.