Szczegóły miejsca (nowość)

Po uzyskaniu identyfikatora miejsca możesz poprosić o więcej szczegółów na temat konkretnej instytucji lub ciekawego miejsca, przesyłając prośbę o szczegóły miejsca (nowe). Żądanie szczegółów miejsca (nowego) zwraca bardziej szczegółowe informacje o danym miejscu, takie jak pełny adres, numer telefonu, ocena użytkowników i opinie.

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

Eksplorator interfejsów API 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 dotyczące miejsca (nowe)

Żądanie informacji o miejscu to żądanie HTTP GET w tym formularzu:

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

Przekazuj wszystkie parametry jako parametry adresu URL lub w nagłówkach w żądaniu 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

Szczegóły dotyczące miejsca (nowe) odpowiedzi

Szczegóły miejsca (nowe) zwraca w odpowiedzi obiekt JSON. W odpowiedzi:

  • Odpowiedź jest reprezentowana przez obiekt Place. Obiekt Place zawiera szczegółowe informacje o tym miejscu.
  • Wartość FieldMask przekazana 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 zwróconych pól. Jeśli pominiesz maskę pola, metoda zwróci błąd.

    Maskowanie pól to dobra praktyka projektowa, która pozwala uniknąć żądania zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania i opłat.

    Określ rozdzieloną przecinkami listę typów danych miejsc do zwrócenia. Na przykład, aby pobrać wyświetlaną nazwę i adres miejsca.

    X-Goog-FieldMask: displayName,formattedAddress

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

    X-Goog-FieldMask: *

    Określ co najmniej jedno z tych pól:

    • Te pola wywołują kod SKU szczegółów miejsca (tylko identyfikatory):

      id, name*, photos

      * Pole name zawiera nazwę zasobu miejsca w formacie: places/PLACE_ID. Użyj opcji displayName, by uzyskać dostęp do tekstowej nazwy miejsca.

    • Poniższe pola wywołują kod SKU szczegółów miejsca (tylko lokalizacja):

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

    • Poniższe pola aktywują kod SKU szczegółów miejsca (podstawowe):

      accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

    • Te pola wywołują kod SKU szczegółów miejsca (zaawansowane):

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

    • Te pola wywołują kod SKU Szczegóły miejsca (preferowane):

      allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, delivery, delivery, delivery, delivery, delivery, delivery,
      servesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

  • placeId

    Identyfikator tekstowy, który jednoznacznie identyfikuje miejsce, zwrócony z funkcji wyszukiwania tekstowego (nowego) lub wyszukiwania w pobliżu (nowego). Więcej informacji o identyfikatorach miejsc znajdziesz w omówieniu identyfikatorów miejsc.

    Ciąg places/PLACE_ID jest też nazywany nazwą zasobu miejsca. W odpowiedzi na żądania dotyczące szczegółów miejsca (nowego), wyszukiwania w pobliżu (nowość) i wyszukiwania tekstowego (nowego) ten ciąg znaków 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 obsługiwane języki, więc ta lista może nie być pełna.
    • Jeśli nie zostanie podany languageCode, interfejs API przyjmuje domyślnie wartość en. Jeśli podasz nieprawidłowy kod języka, interfejs API zwróci błąd INVALID_ARGUMENT.
    • Interfejs API staramy się, aby adres był czytelny zarówno dla użytkownika, jak i dla lokalnych lokalizacji. W tym celu funkcja zwraca adresy w języku lokalnym, transliterację do skryptu zrozumiałego dla użytkownika (w razie potrzeby) z uwzględnieniem preferowanego języka. Wszystkie inne 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 zbiór wyników, które interfejs API wybiera do zwrócenia, oraz na kolejność ich zwracania. Geokoder interpretuje skróty różnie w zależności od języka, np. rodzaje skrótów nazw ulic lub ich synonimy mogą być prawidłowe w jednym języku, a w innym nie.

  • regionCode

    Kod regionu używany do formatowania odpowiedzi, określony jako dwuznakowy kod CLDR. Brak wartości domyślnej.

    Jeśli nazwa kraju w polu formattedAddress w odpowiedzi jest zgodna z wartością regionCode, kod kraju jest pomijany w polu formattedAddress. Ten parametr nie ma wpływu na element adrFormatAddress, który zawsze zawiera nazwę kraju, lub na shortFormattedAddress, który nigdy go nie uwzględnia.

    Większość kodów CLDR jest identyczna z kodami ISO 3166-1 z kilkoma wyjątkami. Na przykład domena ccTLD w Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie oznaczający jednostkę „Wielka Brytania i Irlandia Północna”). Parametr może wpływać na wyniki w zależności od obowiązującego prawa.

  • sessionToken

    Tokeny sesji to ciągi tekstowe generowane przez użytkownika, które śledzą (nowe) wywołania autouzupełniania jako „sesje”. Funkcja autouzupełniania (nowa) używa tokenów sesji do grupowania zapytania i umieszczania faz wyboru autouzupełniania wyszukiwania użytkownika w osobnej sesji na potrzeby rozliczeń. Tokeny sesji są przekazywane do (nowych) wywołań szczegółów miejsca, które następują po wywołaniach autouzupełniania (nowych). Więcej informacji znajdziesz w artykule o tokenach sesji.

Przykład szczegółów miejsca

Ten przykład wymaga przesłania informacji o miejscu według właściwości 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

Pamiętaj, że nagłówek X-Goog-FieldMask wskazuje, że odpowiedź zawiera te pola danych: id,displayName. Odpowiedź ma wtedy postać:

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

Aby zwrócić dodatkowe informacje, do maski pola dodaj więcej typów danych. Na przykład dodaj formattedAddress,plusCode, aby umieścić adres i kod Plus Code 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

Eksplorator interfejsów API umożliwia wykonywanie przykładowych żądań, aby ułatwić Ci zapoznanie się z interfejsem API i jego opcjami.

Aby wysłać prośbę:

  1. Wybierz ikonę interfejsu API Rozwiń sekcję API Explorer. po prawej stronie.
  2. Opcjonalnie ustaw parametr name na: 
    places/PLACE_ID
  3. Opcjonalnie rozwiń opcję 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ć, aby przesłać prośbę.

  5. W panelu Eksplorator interfejsów API wybierz ikonę rozwijania (Rozwiń sekcję API Explorer.), aby rozwinąć okno API Explorer.