Detalhes do lugar (novo)

Selecione a plataforma: Android iOS JavaScript Web Service

Para solicitar mais detalhes sobre um estabelecimento ou ponto de interesse específico, use o ID do lugar e faça uma solicitação do Place Details (novo). O Place Details (New) retorna informações mais abrangentes sobre o lugar indicado, como endereço completo, número de telefone, classificação do usuário e avaliações.

Há muitas maneiras de conseguir um ID de lugar. Você pode usar:

Solicitações de Place Details (novo)

É possível solicitar detalhes de lugares chamando PlacesClient.fetchPlace() e transmitindo um objeto FetchPlaceRequest que contenha um ID de lugar e uma lista de campos, além de 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 recurso "Detalhes do lugar (novo)" retorna dados na forma de um objeto Place, que inclui apenas os campos que você solicitou usando a lista de campos. Os resultados dos dados do lugar não podem ficar vazios. Portanto, apenas os resultados do lugar com dados são retornados. Por exemplo, se um lugar solicitado não tiver fotos, o campo de fotos não vai 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 necessários para FetchPlaceRequest são:

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 do campo Place.Field.FORMATTED_ADDRESS na resposta corresponder ao regionCode, o código do país será omitido de Place.Field.FORMATTED_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), e 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 de código de região, chame o método setRegionCode() ao criar o objeto FetchPlaceRequest.

  • Token da sessão

    Os tokens de sessão são strings geradas pelo usuário que rastreiam as chamadas do Autocomplete (Novo) como "sessões". O preenchimento automático (novo) usa tokens de sessão para agrupar as fases de consulta e seleção de local de uma pesquisa de 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 objeto FetchPlaceRequest.

Exemplo de Place Details

O exemplo a seguir solicita os campos ID, DISPLAY_NAME e FORMATTED_ADDRESS para o Empire State Building em 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.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);