Puedes solicitar más detalles sobre un establecimiento o un lugar de interés en particular usando su ID de lugar y realizando una solicitud de Place Details (nueva). Place Details (nuevo) muestra información más completa sobre el lugar indicado, como la dirección completa, el número de teléfono, las calificaciones y opiniones de los usuarios.
Existen muchas maneras de obtener un ID de lugar. Puedes usar:
Solicitudes de Place Details (nuevo)
Para solicitar detalles de lugar, llama a PlacesClient.fetchPlace()
y pasa un objeto FetchPlaceRequest
que contenga un ID de lugar y una lista de campos, así 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) muestra datos en forma de un objeto Place
, que incluye solo los campos que solicitaste con la lista de campos. Los resultados de datos de lugares no pueden estar vacíos, por lo que solo se muestran resultados de lugares con datos (por ejemplo, si un lugar solicitado no tiene fotos, el campo de fotos no estará presente en el resultado).
Para acceder a los campos de datos, llama al método correspondiente.
Por ejemplo, para acceder al nombre del lugar, llama a getName()
.
Parámetros obligatorios
Los parámetros obligatorios para FetchPlaceRequest
son los siguientes:
-
ID de lugar
Es un identificador textual que identifica un lugar de forma única y que se muestra a partir de Text Search (nueva), Nearby Search (nuevo) o Autocomplete (nuevo). Para obtener más información sobre los IDs de lugar, consulta la descripción general de los IDs de lugar.
-
Lista de campos
Cuando solicitas un lugar, debes especificar qué datos del lugar deseas devolver. Para ello, pasa una lista de valores
Place.Field
que especifique los datos que se mostrarán. No hay una lista predeterminada de campos mostrados en la respuesta.Las listas de campos son una práctica recomendada de diseño para garantizar que no solicites datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación innecesarios.Esta lista es una consideración importante porque afecta el costo de cada solicitud. Para obtener más información, consulta Uso y facturación.
Especifica uno o más de los siguientes campos:
Los siguientes campos activan el SKU de Place Details (solo IDs):
Place.Field.ID
,Place.Field.NAME
,Place.Field.PHOTO_METADATAS
Los siguientes campos activan el SKU de Place Details (solo ubicación):
Place.Field.ADDRESS_COMPONENTS
,Place.Field.ADDRESS
,Place.Field.LAT_LNG
,Place.Field.PLUS_CODE
,Place.Field.TYPES
,Place.Field.VIEWPORT
Los siguientes campos activan el SKU de Place Details (Basic):
Place.Field.BUSINESS_STATUS
,Place.Field.ICON_BACKGROUND_COLOR
,Place.Field.ICON_URL
,Place.Field.UTC_OFFSET
yPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Los siguientes campos activan el SKU de 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
yPlace.Field.WEBSITE_URI
Los siguientes campos activan el SKU de Place Details (preferido):
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
yPlace.Field.TAKEOUT
Parámetros opcionales
Los parámetros opcionales para
FetchPlaceRequest
son los siguientes:
Código de la región
Es el código de región que se usa para dar formato a la respuesta, especificado como un 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 conregionCode
, el código de país se omite dePlace.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 su código ISO 3166-1 es "gb" (técnicamente para la entidad 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 objetoFetchPlaceRequest
.-
Token de sesión
Los tokens de sesión son cadenas generadas por el usuario que hacen un seguimiento de las llamadas de Autocomplete (nuevo) como “sesiones”. Autocomplete (nuevo) usa tokens de sesión para agrupar las fases de búsqueda y selección de lugares de una búsqueda de autocompletado del usuario en una sesión discreta con fines de facturación. Los tokens de sesión se pasan a llamadas de Place Details (nuevo) 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 objetoFetchPlaceRequest
.
Ejemplo de Place Details
En el siguiente ejemplo, se solicitan los campos ID
, NAME
y ADDRESS
para el Empire State Building 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);