Place Details (nuevo)

Selecciona la plataforma: Android iOS JavaScript Servicio web

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:

• Text Search (nueva)
• Nearby Search (nuevo)
• Autocompletar (nuevo)

Nota: Place Details (nuevo) está disponible en el SDK de Places para Android 3.3.0 y versiones posteriores. Para obtener más información, consulta Cómo elegir tu versión del SDK.

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

Puedes usar un CancellationToken para intentar cancelar una solicitud a cualquiera de las clases de solicitud (por ejemplo, FetchPlaceRequest). La cancelación se realiza en función del mejor esfuerzo. Una vez que se emite una solicitud de cancelación, no se devuelve ninguna respuesta. Emitir un token de cancelación NO garantiza la cancelación de una solicitud en particular, y es posible que se te cobre por ella incluso si no se devuelve una respuesta.

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 y Place.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 y Place.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 y Place.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 con 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 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 objeto FetchPlaceRequest.

• 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 objeto FetchPlaceRequest.

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