Szczegóły miejsca (nowość)

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Gdy znasz identyfikator miejsca, możesz poprosić o więcej informacji o konkretnym obiekcie lub punkcie orientacyjnym, wysyłając żądanie Szczegóły miejsca (nowe). Zapytanie dotyczące szczegółów miejsca (nowe) zwraca bardziej szczegółowe informacje o wybranym miejscu, takie jak pełny adres, numer telefonu, ocena i opinie użytkowników.

Identyfikator miejsca można uzyskać na wiele sposobów. Możesz użyć:

Narzędzie APIs Explorer umożliwia wysyłanie żądań na żywo, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami:

prośby o szczegóły miejsca (nowe);

Żądanie szczegółów miejsca to żądanie HTTP GET o postaci:

https://places.googleapis.com/v1/places/PLACE_ID

Przekaż wszystkie parametry jako parametry adresu URL lub w nagłówkach jako część żądania GET. Na przykład:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Lub w komendach 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 „Informacje o miejscu (nowe)”,

Szczegóły miejsca (Nowy) zwracają obiekt JSON jako odpowiedź. W odpowiedzi:

  • Odpowiedź jest reprezentowana przez obiekt Place. Obiekt Place zawiera szczegółowe informacje o miejscu.
  • FieldMask przekazany w żądaniu określa listę pól zwracanych w obiekcie Place.

Pełny obiekt JSON ma postać:

{
  "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ż do metody maskę pola odpowiedzi, używając parametru adresu URL $fields lub fields albo nagłówka HTTP X-Goog-FieldMask. W odpowiedzi nie ma domyślnej listy zwracanych pól. Jeśli pominiesz maskę pola, metoda zwróci błąd.

    Maskowanie pól to dobra praktyka projektowania, która pozwala uniknąć żądania niepotrzebnych danych, co pomaga uniknąć niepotrzebnego czasu przetwarzania i opłat rozliczeniowych.

    Podaj rozdzieloną przecinkami listę typów danych o miejscach, które mają zostać zwrócone. Na przykład: aby pobrać nazwę wyświetlaną i adres miejsca.

    X-Goog-FieldMask: displayName,formattedAddress

    Aby pobrać wszystkie pola, użyj zapytania *.

    X-Goog-FieldMask: *

    Podaj co najmniej 1 z tych pól:

    • Te pola powodują wyświetlenie kodu SKU szczegółów miejsca (tylko identyfikatory):

      attributions
      id
      name*
      photos

      * Pole name zawiera nazwę zasobu miejsca w formie: places/PLACE_ID. Użyj displayName, aby wyświetlić nazwę tekstową miejsca.

    • Te pola powodują wyświetlenie usługi SKU Szczegóły miejsca (tylko lokalizacja):

      addressComponents
      adrFormatAddress
      formattedAddress
      location
      plusCode
      shortFormattedAddress
      types
      viewport

    • Te pola powodują wyświetlenie identyfikatora SKU Szczegóły miejsca (podstawowe):

      accessibilityOptions
      businessStatus
      containingPlaces
      displayName
      googleMapsLinks*
      googleMapsUri
      iconBackgroundColor
      iconMaskBaseUri
      primaryType
      primaryTypeDisplayName
      pureServiceAreaBusiness
      subDestinations
      utcOffsetMinutes

      * Pole googleMapsLinks znajduje się w fazie podglądu przed GA i nie jest płatne, co oznacza, że za korzystanie z niego w trakcie podglądu nie jest naliczana opłata.

    • Te pola powodują wyświetlenie usługi SKU Szczegóły miejsca (zaawansowane):

      currentOpeningHours
      currentSecondaryOpeningHours
      internationalPhoneNumber
      nationalPhoneNumber
      priceLevel
      priceRange
      rating
      regularOpeningHours
      regularSecondaryOpeningHours
      userRatingCount
      websiteUri

    • Te pola powodują wyświetlenie kodu SKU „Szczegóły miejsca” (preferowany):

      allowsDogs
      curbsidePickup
      delivery
      dineIn
      editorialSummary
      evChargeOptions
      fuelOptions
      goodForChildren
      goodForGroups
      goodForWatchingSports
      liveMusic
      menuForChildren
      parkingOptions
      paymentOptions
      outdoorSeating
      reservable
      restroom
      reviews
      routingSummaries*
      servesBeer
      servesBreakfast
      servesBrunch
      servesCocktails
      servesCoffee
      servesDessert
      servesDinner
      servesLunch
      servesVegetarianFood
      servesWine
      takeout

      * Tylko w wyszukiwarce tekstowej i wyszukiwarce w pobliżu

  • placeId

    Tekstowy identyfikator jednoznacznie identyfikujący miejsce, zwracany z 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 tekstowy places/PLACE_ID to także nazwa zasobu. W odpowiedzi na żądanie dotyczące szczegółów miejsca (nowa usługa), wyszukiwania w pobliżu (nowa usługa) i wyszukiwania tekstowego (nowa usługa) ten ciąg tekstowy znajduje się w polu name odpowiedzi. Samodzielny 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 listę obsługiwanych języków, więc może ona nie być kompletna.
    • Jeśli nie podasz parametru languageCode, interfejs API użyje domyślnej wartości en. Jeśli określisz nieprawidłowy kod języka, API zwróci błąd INVALID_ARGUMENT.
    • Interfejs API stara się podać adres ulicy, który jest czytelny zarówno dla użytkownika, jak i dla mieszkańców. Aby to osiągnąć, zwraca adresy ulic w języku lokalnym, transliterowane do postaci zrozumiałej dla użytkownika, jeśli to konieczne, w preferowanym języku. Wszystkie inne adresy są zwracane w preferowanym języku. Wszystkie elementy adresu są zwracane w tym samym języku, który jest wybierany na podstawie pierwszego komponentu.
    • Jeśli nazwa nie jest dostępna w preferowanym języku, interfejs API stosuje najbliższe dopasowanie.
    • Preferowany język ma niewielki wpływ na zestaw wyników zwracanych przez interfejs API oraz na ich kolejność. Geokoder interpretuje skróty w różny sposób w zależności od języka, np. skróty typów ulic lub synonimy, które mogą być prawidłowe w jednym języku, ale nie w innym.

  • regionCode

    Kod regionu użyty do sformatowania odpowiedzi, podany jako 2-znakowy kod CLDR. Nie ma wartości domyślnej.

    Jeśli nazwa kraju w polu formattedAddress w odpowiedzi jest zgodna z polem regionCode, kod kraju jest pomijany w polu formattedAddress. Ten parametr nie ma wpływu na adrFormatAddress, który zawsze zawiera nazwę kraju, ani na shortFormattedAddress, która nigdy nie zawiera nazwy kraju.

    Większość kodów CLDR jest identyczna z kodami ISO 3166-1, z niektórymi wyjątkami. Na przykład ccTLD Wielkiej Brytanii to „uk” (.co.uk), a jej kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”). Parametr może wpływać na wyniki w zależności od obowiązujących przepisów.

  • sessionToken

    Tokeny sesji to tworzone przez użytkownika ciągi znaków, które śledzą wywołania funkcji Autouzupełnianie (nowa), traktując je jako „sesje”. Autouzupełnianie (nowa wersja) używa tokenów sesji, aby grupować fazy zapytania i wyboru miejsca w autouzupełnianiu w ramach jednej sesji na potrzeby rozliczeń. Tokeny sesji są przekazywane do wywołań Szczegóły miejsca (Nowe), które następują po wywołaniach Autouzupełnianie (Nowe). Więcej informacji znajdziesz w artykule Tokeny sesji.

Przykład informacji o miejscu

W tym przykładzie placeId prosi o szczegóły miejsca:

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

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Dodaj do maski pola dodatkowe typy danych, aby zwracać dodatkowe informacje. 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 postać:

{
  "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

Narzędzie APIs Explorer umożliwia wysyłanie przykładowych żądań, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami.

  1. Po prawej stronie strony kliknij ikonę interfejsu API api.

  2. Opcjonalnie możesz zmodyfikować parametry żądania.

  3. Kliknij przycisk Wykonaj. W oknie wybierz konto, którego chcesz użyć do wysłania prośby.

  4. W panelu narzędzia APIs Explorer kliknij ikonę pełnego ekranu Pełny ekran, aby rozwinąć okno narzędzia APIs Explorer.