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 prośbę 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, oceny i opinie użytkowników.

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

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

Wypróbuj

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 danym 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 jest w fazie przed GA Preview i nie jest płatne, co oznacza, że za korzystanie z niego w fazie Preview 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 wyszukiwanie tekstowe i wyszukiwanie 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 dokłada wszelkich starań, aby podać adres ulicy, który jest czytelny dla użytkownika i 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 wartością w polu 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) 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 API Explorer umożliwia wysyłanie przykładowych żądań, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami.

Aby poprosić o pomoc:

  1. Po prawej stronie strony kliknij ikonę interfejsu API Rozwiń narzędzie API Explorer..
  2. Opcjonalnie ustaw parametr name na: 
    places/PLACE_ID
  3. Opcjonalnie rozwiń Pokaż parametry standardowe i ustaw parametr fields na maskę pola.
  4. Kliknij przycisk Wykonaj. W wyskakującym okienku wybierz konto, którego chcesz użyć do wysłania żądania.

  5. W panelu API Explorer kliknij ikonę rozwijania Rozwiń narzędzie API Explorer., aby rozwinąć okno API Explorer.