Szczegóły miejsca (nowość)

Wybierz platformę: Android iOS JavaScript Usługa internetowa

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Możesz poprosić o więcej informacji o konkretnym obiekcie lub punkcie orientacyjnym, używając jego identyfikatora miejsca i wysyłając żądanie Szczegóły miejsca (nowe). Szczegóły miejsca (nowe) zwracają 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ć:

Prośby o informacje o miejscu (nowe)

Możesz poprosić o szczegóły miejsca, wywołując funkcję PlacesClient.fetchPlace() i przekazując obiekt FetchPlaceRequest zawierający identyfikator miejsca i listę pól, a także opcjonalne parametry:

// 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 dotyczące informacji o miejscu (nowe)

Szczegóły miejsca (nowe) zwracają dane w postaci obiektu Place, który zawiera tylko pola, o które prosisz w liście pól. Wyniki danych o miejscach nie mogą być puste, więc zwracane są tylko wyniki miejsc z danymi (np. jeśli żądane miejsce nie ma zdjęć, pole zdjęć nie będzie obecne w wyniku).

Aby uzyskać dostęp do pól danych, wywołaj odpowiednią metodę. Aby na przykład uzyskać dostęp do nazwy miejsca, wywołaj getName().

Wymagane parametry

Wymagane parametry dla FetchPlaceRequest to:

  • Identyfikator miejsca

    Identyfikator tekstowy, który jednoznacznie identyfikuje miejsce. Jest zwracany przez interfejsy Text Search (New), Nearby Search (New) lub Autocomplete (New). Więcej informacji o identyfikatorach miejsc znajdziesz w omówieniu identyfikatorów miejsc.

  • Lista pól

    Gdy wysyłasz prośbę o miejsce, musisz określić, które dane o miejscu mają zostać zwrócone. Aby to zrobić, przekaż listę wartości Place.Field określających dane, które mają zostać zwrócone. W odpowiedzi nie ma domyślnej listy zwracanych pól.

    Listy pól to dobra praktyka projektowania, która pozwala uniknąć wysyłania zapytań o niepotrzebne dane. Dzięki temu można skrócić czas przetwarzania i uniknąć niepotrzebnych opłat. Ta lista jest ważna, ponieważ wpływa na koszt każdego żądania. Więcej informacji znajdziesz w sekcji Wykorzystanie i rozliczenia.

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

    • Te pola wywołują SKU „Tylko identyfikatory podstawowych informacji o miejscu”:

      Place.Field.ID
      Place.Field.PHOTO_METADATAS
      Place.Field.RESOURCE_NAME

    • Te pola wywołują podstawowy SKU szczegółów miejsca:

      Place.Field.ADDRESS_COMPONENTS
      ADR_FORMAT_ADDRESS
      Place.Field.FORMATTED_ADDRESS*
      * Zamiast Place.Field.ADDRESS (wycofano).
      Place.Field.LOCATION*
      * Używaj zamiast Place.Field.LAT_LNG (wycofano).
      Place.Field.PLUS_CODE
      Place.Field.SHORT_FORMATTED_ADDRESS
      Place.Field.TYPES
      Place.Field.VIEWPORT

    • Te pola wywołują SKU Szczegóły miejsca Pro:

      Place.Field.ACCESSIBILITY_OPTIONS*
          * Używaj zamiast Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (wycofano).
      Place.Field.BUSINESS_STATUS
      Place.Field.DISPLAY_NAME*
          * Używaj zamiast wycofanej funkcji Place.Field.NAME.
      Place.Field.GOOGLE_MAPS_URI
      Place.Field.ICON_BACKGROUND_COLOR
      Place.Field.ICON_MASK_URL*
          * Użyj zamiast Place.Field.ICON_URL (wycofano).
      Place.Field.PRIMARY_TYPE
      Place.Field.PRIMARY_TYPE_DISPLAY_NAME
      Place.Field.SUB_DESTINATIONS
      Place.Field.UTC_OFFSET

    • Te pola wywołują kod SKU Szczegóły miejsca w wersji Enterprise:

      Place.Field.CURRENT_OPENING_HOURS
      Place.Field.CURRENT_SECONDARY_OPENING_HOURS
      Place.Field.INTERNATIONAL_PHONE_NUMBER*
          * Używaj zamiast wycofanego parametru Place.Field.PHONE_NUMBER.
      Place.Field.NATIONAL_PHONE_NUMBER
      Place.Field.OPENING_HOURS
      Place.Field.PRICE_LEVEL
      Place.Field.RATING
      Place.Field.SECONDARY_OPENING_HOURS
      Place.Field.USER_RATING_COUNT*
          * Użyj zamiast wycofanego parametru Place.Field.USER_RATINGS_TOTAL.
      Place.Field.WEBSITE_URI

    • Te pola wywołują kod SKU Szczegóły miejsca Enterprise Plus:

      Place.Field.ALLOWS_DOGS
      Place.Field.CURBSIDE_PICKUP
      Place.Field.DELIVERY
      Place.Field.DINE_IN
      Place.Field.EDITORIAL_SUMMARY
      Place.Field.EV_CHARGE_OPTIONS
      Place.Field.FUEL_OPTIONS
      Place.Field.GOOD_FOR_CHILDREN
      Place.Field.GOOD_FOR_GROUPS
      Place.Field.GOOD_FOR_WATCHING_SPORTS
      Place.Field.LIVE_MUSIC
      Place.Field.MENU_FOR_CHILDREN
      Place.Field.OUTDOOR_SEATING
      Place.Field.PARKING_OPTIONS
      Place.Field.PAYMENT_OPTIONS
      Place.Field.RESERVABLE
      Place.Field.RESTROOM
      Place.Field.REVIEWS
      Place.Field.SERVES_BEER
      Place.Field.SERVES_BREAKFAST
      Place.Field.SERVES_BRUNCH
      Place.Field.SERVES_COCKTAILS
      Place.Field.SERVES_COFFEE
      Place.Field.SERVES_DESSERT
      Place.Field.SERVES_DINNER
      Place.Field.SERVES_LUNCH
      Place.Field.SERVES_VEGETARIAN_FOOD
      Place.Field.SERVES_WINE
      Place.Field.TAKEOUT

Parametry opcjonalne

Parametry opcjonalne dla FetchPlaceRequest to:

  • Kod regionu

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

    Jeśli nazwa kraju w polu Place.Field.FORMATTED_ADDRESS w odpowiedzi jest zgodna z wartością regionCode, kod kraju jest pomijany w polu Place.Field.FORMATTED_ADDRESS.

    Większość kodów CLDR jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”). W zależności od obowiązujących przepisów parametr może wpływać na wyniki.

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

  • Token sesji

    Tokeny sesji to wygenerowane przez użytkownika ciągi znaków, które śledzą wywołania funkcji Autocomplete (nowa) jako „sesje”. Autouzupełnianie (nowe) używa tokenów sesji do grupowania faz zapytania i wyboru miejsca w wyszukiwaniu autouzupełniania użytkownika w osobnej sesji na potrzeby rozliczeń. Tokeny sesji są przekazywane do wywołań Place Details (New) po wywołaniach Autocomplete (New). Więcej informacji znajdziesz w sekcji Tokeny sesji.

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

Przykład komponentu Informacje o miejscu

W tym przykładzie wysyłamy prośbę o pola ID, DISPLAY_NAME i FORMATTED_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.DISPLAY_NAME, Place.Field.FORMATTED_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);