Para pedir mais detalhes sobre um estabelecimento ou ponto de interesse específico, use o ID de lugar correspondente e faça uma solicitação do Place Details (novo). Place Details (novo) retorna informações mais abrangentes sobre o lugar indicado, como endereço completo, número de telefone, classificação e avaliações de usuários.
Há muitas maneiras de se obter um ID de lugar. Você pode usar:
Solicitações de Place Details (novo)
Para solicitar detalhes do lugar, chame PlacesClient.fetchPlace()
e transmita um objeto FetchPlaceRequest
que contém um ID de lugar e uma lista de campos, bem como todos os parâmetros opcionais:
// 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);
Respostas do Place Details (novo)
O Place Details (novo) retorna dados na forma de um objeto Place
, que inclui apenas os campos solicitados usando a lista de campos. Os resultados de dados de lugares não podem ficar vazios. Portanto, apenas os resultados com dados são retornados. Por exemplo, se um lugar solicitado não tiver fotos, o campo de fotos não estará presente no resultado.
Para acessar campos de dados, chame o método correspondente.
Por exemplo, para acessar o nome do lugar, chame getName()
.
Parâmetros obrigatórios
Os parâmetros obrigatórios para
FetchPlaceRequest
são:
-
ID do lugar
Um identificador textual que identifica um local de forma exclusiva, retornado de uma Text Search (novo), Nearby Search (novo) ou Autocomplete (novo). Para mais informações sobre IDs de lugar, consulte a visão geral de IDs de lugar.
-
Lista de campos
Ao solicitar um lugar, é necessário especificar quais dados retornar. Para fazer isso, transmita uma lista de valores
Place.Field
especificando os dados a serem retornados. Não há uma lista padrão de campos retornados na resposta.As listas de campos são uma prática recomendada de design para garantir que você não solicite dados desnecessários. Isso ajuda a evitar cobranças desnecessárias no tempo de processamento e nas cobranças. Essa lista é importante porque afeta o custo de cada solicitação. Para mais informações, consulte Uso e faturamento.
Especifique um ou mais dos seguintes campos:
Os campos a seguir acionam a SKU do Place Details (somente IDs):
Place.Field.ID
,Place.Field.NAME
,Place.Field.PHOTO_METADATAS
Os campos a seguir acionam a SKU do Place Details (somente local):
Place.Field.ADDRESS_COMPONENTS
,Place.Field.ADDRESS
,Place.Field.LAT_LNG
,Place.Field.PLUS_CODE
,Place.Field.TYPES
ePlace.Field.VIEWPORT
Os campos a seguir acionam a SKU do Place Details (Basic):
Place.Field.BUSINESS_STATUS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_URL
,Place.Field.UTC_OFFSET
,Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Os campos a seguir acionam a SKU do Place Details (Advanced):
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
Os campos a seguir acionam a SKU do Place Details (Preferencial):
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
ePlace.Field.TAKEOUT
Parâmetros opcionais
Os parâmetros opcionais de
FetchPlaceRequest
são:
Código de região
O código da região usado para formatar a resposta, especificado como um valor de código CLDR de dois caracteres. Não há valor padrão.
Se o nome do país no campo
Place.Field.ADDRESS
na resposta corresponder aregionCode
, o código do país será omitido dePlace.Field.ADDRESS
.A maioria dos códigos CLDR é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Por exemplo, o ccTLD do Reino Unido é "uk" (.co.uk), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade "Reino Unido da Grã-Bretanha e Irlanda do Norte"). O parâmetro pode afetar os resultados com base na legislação aplicável.
Para definir o parâmetro do código da região, chame o método
setRegionCode()
ao criar o objetoFetchPlaceRequest
.-
Token da sessão
Tokens de sessão são strings geradas pelo usuário que rastreiam chamadas de preenchimento automático (novo) como "sessões". O Autocomplete (novo) usa tokens de sessão para agrupar as fases de consulta e seleção de local de uma pesquisa com preenchimento automático do usuário em uma sessão discreta para fins de faturamento. Os tokens de sessão são transmitidos para as chamadas do Place Details (novo) que seguem as chamadas do Autocomplete (novo). Para mais informações, consulte Tokens de sessão.
Para definir o parâmetro do token de sessão, chame o método
setSessionToken()
ao criar o objetoFetchPlaceRequest
.
Exemplo de Place Details
O exemplo a seguir solicita os campos ID
, NAME
e ADDRESS
para o Empire State Building na cidade de Nova York.
// 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);