Place Details (nuevo)

Selecciona la plataforma: Android iOS JavaScript Servicio web

Puedes solicitar más detalles sobre un establecimiento o punto de interés usando su lugar de la API y crea un Solicitud de Place Details (nueva). La versión más completa de Place Details (nuevo) información sobre el lugar indicado, como su dirección completa, número de el número, las calificaciones y las opiniones de los usuarios.

Existen muchas maneras de obtener un ID de lugar. Puedes usar:

Solicitudes de Place Details (nuevo)

Para solicitar detalles del lugar, llama a PlacesClient.fetchPlace() y pasar un FetchPlaceRequest objeto que contiene un ID de lugar y una lista de campos, así como como cualquier parámetro opcional:

// 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);

Respuestas de Place Details (nuevo)

Place Details (nuevo) devuelve datos como un archivo Place que incluye solo los campos que solicitaste usando el campo en la lista de lectura. Los resultados de datos de lugares no pueden estar vacíos; por lo tanto, solo los resultados de lugares con datos (por ejemplo, si un sitio solicitado no tiene fotos, la fotos no aparecerá en el resultado).

Para acceder a los campos de datos, llama a método. Por ejemplo, para acceder al nombre del lugar, llama a getName().

Parámetros obligatorios

Los parámetros obligatorios para FetchPlaceRequest son:

Parámetros opcionales

Los parámetros opcionales para FetchPlaceRequest son:

  • Código de la región

    El código de región que se usa para dar formato a la respuesta, especificado como una valor de código CLDR de dos caracteres. No hay un valor predeterminado.

    Si el nombre del país del campo Place.Field.ADDRESS en la respuesta coincide con el regionCode, el código de país se omite de Place.Field.ADDRESS.

    La mayoría de los códigos CLDR son idénticos a los códigos ISO 3166-1, con algunas excepciones notables. Por ejemplo, el ccTLD del Reino Unido es “uk” (.co.uk), mientras que el código ISO 3166-1 es "gb" (técnicamente para el del "Reino Unido de Gran Bretaña e Irlanda del Norte"). El parámetro puede afectar los resultados según la ley aplicable.

    Para establecer el parámetro de código de región, llama al método setRegionCode() cuando compiles el objeto FetchPlaceRequest.

  • Token de sesión

    Los tokens de sesión son cadenas generadas por el usuario que hacen un seguimiento Llamadas de Autocomplete (nuevas) como "sesiones". Autocomplete (nuevo) usa tokens de sesión para Agrupar las fases de consulta y selección de lugares de una búsqueda de autocompletado del usuario en una sesión discreta para la facturación. Los tokens de sesión se pasan a Place Details (nuevo) de llamadas que siguen a las de Autocomplete (nuevo). Para obtener más información, consulta Tokens de sesión.

    Para establecer el parámetro del token de sesión, llama al método setSessionToken() cuando compiles el objeto FetchPlaceRequest.

Ejemplo de Place Details

En el siguiente ejemplo, se solicitan los campos ID, NAME y ADDRESS para la Empire State en la ciudad de Nueva 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);