Szczegóły miejsca (nowość)

Możesz poprosić o więcej szczegółowych informacji na temat określonego podmiotu lub punktu zainteresowania, podając miejsce ID i utworzyć Prośba o szczegóły miejsca (nowa). Szczegóły miejsca (nowość) zwracają bardziej kompleksowe informacje informacje o wybranym miejscu, takie jak pełny adres, numer telefonu liczby użytkowników, oceny użytkowników i opinie.

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

• Wyszukiwanie tekstowe (nowość)
• Wyszukiwanie w pobliżu (nowość)
• Autouzupełnianie (nowość)

Prośby o szczegóły miejsca (nowe)

Aby uzyskać szczegółowe informacje o miejscu, zadzwoń pod numer PlacesClient.fetchPlace() i zaliczenie FetchPlaceRequest obiekt zawierający identyfikator miejsca i listę pól, a także jako dowolne parametry opcjonalne:

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

Odpowiedzi na temat szczegółów miejsca (nowe)

Szczegóły miejsca (nowość) zwraca dane w postaci Place który zawiera tylko żądane pola za pomocą pola . Wyniki z danymi miejsc nie mogą być puste, więc należy umieszczać tylko wyniki z danymi (jeśli na przykład żądane miejsce nie ma zdjęć, zostanie „Zdjęcia” nie powinno się znajdować w wynikach).

Aby uzyskać dostęp do pól danych, wywołaj odpowiednie pole metoda. Na przykład aby uzyskać dostęp do nazwy miejsca, wywołaj getName().

Wymagane parametry

Parametry wymagane dla FetchPlaceRequest to:

• Identyfikator miejsca

  identyfikator tekstowy, który jednoznacznie identyfikuje miejsce, zwrócony z Wyszukiwanie tekstowe (nowe), Wyszukiwanie w pobliżu (nowość) lub Autouzupełnianie (nowość). Więcej informacji o identyfikatorach miejsc znajdziesz tutaj: omówienie identyfikatora miejsca.

• Lista pól

  Zgłaszając prośbę o dane miejsce, musisz określić, które dane o nim mają zostać zwrócone. Do w tym celu przekaż listę wartości Place.Field określając dane do zwrócenia. Nie ma domyślnej listy zwrócone pola w odpowiedzi.

  Listy pól to dobry sposób na ich projektowanie, by uniknąć zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania oraz wszelkie opłaty związane z płatnościami.Ta lista należy wziąć pod uwagę, ponieważ wpływa na koszt każdego żądania. Więcej informacji: Wykorzystanie i Płatności.

  Wypełnij co najmniej jedno z tych pól:

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

    Place.Field.ID, Place.Field.NAME, Place.Field.PHOTO_METADATAS

  • Te pola aktywują kod SKU szczegółów miejsca (tylko lokalizacja):

    Place.Field.ADDRESS_COMPONENTS, Place.Field.ADDRESS, Place.Field.LAT_LNG, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT

  • Te pola aktywują kod SKU Szczegóły miejsca (podstawowe):

    Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.UTC_OFFSET, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

  • Te pola aktywują kod SKU szczegółów miejsca (preferowany):

    Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

Parametry opcjonalne

Opcjonalne parametry FetchPlaceRequest to:

• Kod regionu

  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 Place.Field.ADDRESS w odpowiedzi jest zgodna z nazwą kraju regionCode, kod kraju został pominięty w: Place.Field.ADDRESS.

  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.

  Aby ustawić parametr kodu regionu, wywołaj metodę setRegionCode() podczas tworzenia obiektu FetchPlaceRequest.

• Token sesji

  Tokeny sesji to generowane przez użytkownika ciągi tekstowe, które śledzą Autouzupełnianie (nowych) połączeń jako „sesji”. Autouzupełnianie (nowość) korzysta z tokenów sesji do Pogrupować zapytanie i umieścić fazy wyboru wyszukiwania autouzupełniania w oddzielnej sesji do celów rozliczeniowych. Tokeny sesji są przekazywane do szczegółów miejsca (nowe) połączeń następujących po połączeniach autouzupełniania (nowych). Więcej informacji: Tokeny sesji.

  Aby ustawić parametr tokena sesji, podczas tworzenia obiektu FetchPlaceRequest wywołaj metodę setSessionToken().

Przykład strony Szczegóły miejsca

Ten przykład wymaga pól ID, NAME i ADDRESS dla: Empire State Building w Nowym Jorku.

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);