Place Details

Seleccionar plataforma: Android iOS JavaScript Servicio web

El SDK de Places para Android proporciona a tu app información detallada sobre los lugares, incluidos el nombre y la dirección del lugar, la ubicación geográfica especificada como coordenadas de latitud y longitud, el tipo de lugar (como un club nocturno, una tienda de mascotas, un museo), entre otros. Para acceder a esta información de un lugar específico, puedes usar el ID de lugar, un identificador estable que identifica un lugar de forma exclusiva.

Detalles del lugar

El objeto Place proporciona información sobre un lugar específico. Puedes obtener un objeto Place de las siguientes maneras:

• Llama a PlacesClient.findCurrentPlace(): Consulta la guía para obtener el lugar actual.
• Llama a PlacesClient.fetchPlace(): Consulta la guía para obtener un lugar por ID.

Cuando solicitas un lugar, debes especificar qué datos de lugar se mostrarán. Para ello, pasa una lista de valores de Place.Field que especifiquen los datos que se mostrarán. Esta lista es una consideración importante porque afecta el costo de cada solicitud.

Debido a que los resultados de datos de lugar no pueden estar vacíos, solo se muestran los resultados de lugares con datos (por ejemplo, si un lugar solicitado no tiene fotos, el campo photos no estará presente en el resultado).

En el siguiente ejemplo, se pasa una lista de tres valores de Place.Field para especificar los datos que muestra una solicitud:

Java

// Specify the fields to return.
final List placeFields = Arrays.asList(Place.Field.NAME, Place.Field.RATING, Place.Field.OPENING_HOURS);

Kotlin

// Specify the fields to return.
val placeFields = listOf(Place.Field.NAME, Place.Field.RATING, Place.Field.OPENING_HOURS)

Nota: findCurrentPlace() y fetchPlace() admiten diferentes conjuntos de campos. findCurrentPlace() NO admite los siguientes campos: Place.Field.ADDRESS_COMPONENTS, Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.TAKEOUT, Place.Field.UTC_OFFSET y Place.Field.WEBSITE_URI.

Después de obtener el objeto Place, usa métodos del objeto para recuperar los datos del lugar. A continuación, se muestran algunos ejemplos de algunos de los métodos disponibles. Para obtener una lista completa de todos los métodos, consulta la referencia de la API de Place.

• getAddress(): Es la dirección del lugar, en formato de lenguaje natural.
• getAddressComponents(): Es un List de componentes de dirección para este lugar. Estos componentes se proporcionan con el fin de extraer información estructurada sobre la dirección de un lugar, por ejemplo, para encontrar la ciudad en la que se encuentra un lugar. No uses estos componentes para dar formato a las direcciones. En su lugar, llama a getAddress(), que proporciona una dirección con formato localizada.
• getID(): el identificador textual del lugar. Obtén más información sobre los IDs de lugar en el resto de esta página.
• getLatLng(): la ubicación geográfica del lugar, especificada como coordenadas de latitud y longitud.
• getName(): el nombre del lugar.
• getOpeningHours(): Indica el OpeningHours del lugar. Llama a OpeningHours.getWeekdayText() para que se muestre una lista de strings que representan el horario de apertura y cierre de cada día de la semana. Llama a OpeningHours.getPeriods() para mostrar una lista de objetos period con información más detallada equivalente a los datos proporcionados por getWeekdayText(). Nota: Si un lugar siempre está abierto, el período se representa como domingo a la medianoche y el valor de closeEvent es nulo.
• isOpen(): Es un valor booleano que indica si el lugar está abierto en ese momento. Si no se especifica la hora, el valor predeterminado será ahora. isOpen solo se mostrará si Place.Field.UTC_OFFSET y Place.Field.OPENING_HOURS están disponibles. Para garantizar resultados precisos, solicita los campos Place.Field.BUSINESS_STATUS y Place.Field.UTC_OFFSET en tu solicitud de lugar original. Si no se solicita, se supone que la empresa está operativa. Consulta este video para obtener información sobre cómo usar isOpen con Place Details.

Algunos ejemplos simples:

Java

final CharSequence name = place.getName();
final CharSequence address = place.getAddress();
final LatLng location = place.getLatLng();

      

Kotlin

val name = place.name
val address = place.address
val location = place.latLng

      

Obtener un sitio por id.

Un ID de lugar es un identificador textual que identifica de forma exclusiva un lugar. En el SDK de Places para Android, puedes llamar a Place.getId() para recuperar el ID de un lugar. El servicio de Place Autocomplete también muestra un ID de lugar para cada lugar que coincide con la búsqueda y el filtro proporcionados. Puedes almacenar el ID de lugar y usarlo para recuperar el objeto Place más tarde.

Para obtener un lugar por ID, llama a PlacesClient.fetchPlace() y pasa un FetchPlaceRequest.

La API muestra un FetchPlaceResponse en un Task. El FetchPlaceResponse contiene un objeto Place que coincide con el ID de lugar proporcionado.

En el siguiente ejemplo de código, se muestra cómo llamar a fetchPlace() para obtener detalles del lugar especificado.

Java

// Define a Place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    Log.i(TAG, "Place found: " + place.getName());
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        final ApiException apiException = (ApiException) exception;
        Log.e(TAG, "Place not found: " + exception.getMessage());
        final int statusCode = apiException.getStatusCode();
        // TODO: Handle error with given status code.
    }
});

      

Kotlin

// Define a Place ID.
val placeId = "INSERT_PLACE_ID_HERE"

// Specify the fields to return.
val placeFields = listOf(Place.Field.ID, Place.Field.NAME)

// Construct a request object, passing the place ID and fields array.
val request = FetchPlaceRequest.newInstance(placeId, placeFields)

placesClient.fetchPlace(request)
    .addOnSuccessListener { response: FetchPlaceResponse ->
        val place = response.place
        Log.i(PlaceDetailsActivity.TAG, "Place found: ${place.name}")
    }.addOnFailureListener { exception: Exception ->
        if (exception is ApiException) {
            Log.e(TAG, "Place not found: ${exception.message}")
            val statusCode = exception.statusCode
            TODO("Handle error with given status code")
        }
    }

      

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 muestra ninguna respuesta. La emisión de un token de cancelación NO garantiza que una solicitud en particular se cancelará. Además, es posible que se te cobre por la solicitud incluso si no se muestra ninguna respuesta.

Mostrar atribuciones en tu aplicación

Cuando tu app muestra información de lugares, también debe mostrar atribuciones. Consulta la documentación sobre las atribuciones.

Más información sobre los id. de sitio

El ID de lugar que se usa en el SDK de Places para Android es el mismo que se usa en la API de Places. Cada ID de lugar puede referirse a un solo lugar, pero un solo lugar puede tener más de un ID de lugar. Existen otras circunstancias que pueden hacer que un sitio obtenga un nuevo id. de sitio. Por ejemplo, esto puede suceder si una empresa se muda a otro lugar.

Cuando solicitas un sitio mediante la especificación de un ID de lugar, puedes estar seguro de que siempre recibirás el mismo lugar en la respuesta (si el lugar todavía existe). Sin embargo, ten en cuenta que la respuesta puede contener un ID de lugar diferente del que aparece en tu solicitud.

Para obtener más información, consulta la descripción general de los IDs de lugar.