Place Photos

Selecciona la plataforma: Android iOS JavaScript Servicio web

Puedes usar el SDK de Places para Android a fin de solicitar una foto de un lugar para mostrar en tu aplicación. Las fotos que muestra el servicio de fotos provienen de diversas fuentes, como propietarios de empresas y fotos aportadas por los usuarios. Para recuperar una imagen de un sitio, debes seguir estos pasos:

1. Usa Place Details para recuperar un objeto Place (usa fetchPlace() o findCurrentPlace()). Asegúrate de incluir el campo Place.Field PHOTO_METADATAS en la lista de campos que se incluirán en el objeto Place de respuesta.
2. En el OnSuccessListener de tu FetchPlaceResponse o FindCurrentPlaceResponse, haz lo siguiente:
   1. Usa Place.getPhotoMetadas() para obtener el objeto de metadatos de la foto, de tipo PhotoMetadata, del objeto Place de respuesta.
      Nota: El contenido del objeto PhotoMetadata en el objeto Place de respuesta depende de tu versión del SDK: SDK de Places para Android o SDK de Places para Android (nuevo). Para obtener más información, consulta Cómo acceder a los datos nuevos de PhotoMetadata para la versión 3.3.0.
   2. Crea un objeto FetchPhotoRequest y, de manera opcional, especifica la altura y el ancho máximos (en píxeles). Las fotos pueden tener un ancho o una altura máximos de 1,600 px.
   3. Usa PlacesClient.fetchPhoto() para solicitar la foto.
   4. Agrega un elemento OnSuccessListener y obtén la foto desde FetchPhotoResponse.

Acceder a los datos de PhotoMetadata agregados en la versión 3.3.0

El SDK de Places para Android (nuevo) agrega el campo AuthorAttributions a la clase PhotoMetadata. Si tu app habilita el SDK nuevo, el objeto PhotoMetadata que muestra Place.getPhotoMetadas() puede contener una o más atribuciones de autor.

Nota: El nuevo SDK solo admite los nuevos datos de PhotoMetadata en Java.

Cuando el objeto PhotoMetadata contiene atribuciones, ya sea las nuevas atribuciones del autor agregadas en la versión 3.3.0 o las atribuciones existentes disponibles en la versión 3.2.0 y anteriores, debes mostrarlas con la foto. Para obtener más información sobre cómo controlar todos los tipos de atribuciones, consulta Atribuciones.

Para propagar el objeto PhotoMetadata con atribuciones de autor, debes hacer lo siguiente:

1. Habilita el SDK nuevo cuando configures tu proyecto de Google Cloud.
Nota: El SDK de Places para Android y el SDK de Places para Android (nuevo) admiten diferentes modelos de precios. Para obtener información detallada sobre los precios de ambos SDK, consulta Uso y facturación.
2. Inicializa el SDK nuevo dentro de una actividad o un fragmento.
3. Incluye el Place.Field.PHOTO_METADATAS en la lista de campos de la solicitud de detalles del lugar.
4. Llama a PlacesClient.fetchPlace() para obtener el objeto Place y a Place.getPhotoMetadas() para obtener el objeto PhotoMetadata. El campo de atribuciones del autor no es compatible con PlacesClient.findCurrentPlace().
5. Usa PhotoMetadata.getAuthorAttributions() para obtener las atribuciones del autor.

Obtén una foto de un lugar

En el siguiente ejemplo, se muestra cómo obtener una foto de un lugar.

Kotlin

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

// Specify fields. Requests for photos must always have the PHOTO_METADATAS field.
val fields = listOf(Place.Field.PHOTO_METADATAS)

// Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace())
val placeRequest = FetchPlaceRequest.newInstance(placeId, fields)

placesClient.fetchPlace(placeRequest)
    .addOnSuccessListener { response: FetchPlaceResponse ->
        val place = response.place

        // Get the photo metadata.
        val metada = place.photoMetadatas
        if (metada == null || metada.isEmpty()) {
            Log.w(TAG, "No photo metadata.")
            return@addOnSuccessListener
        }
        val photoMetadata = metada.first()

        // Get the attribution text.
        val attributions = photoMetadata?.attributions

        // Create a FetchPhotoRequest.
        val photoRequest = FetchPhotoRequest.builder(photoMetadata)
            .setMaxWidth(500) // Optional.
            .setMaxHeight(300) // Optional.
            .build()
        placesClient.fetchPhoto(photoRequest)
            .addOnSuccessListener { fetchPhotoResponse: FetchPhotoResponse ->
                val bitmap = fetchPhotoResponse.bitmap
                imageView.setImageBitmap(bitmap)
            }.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.")
                }
            }
    }

      

Java

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

// Specify fields. Requests for photos must always have the PHOTO_METADATAS field.
final List<Place.Field> fields = Collections.singletonList(Place.Field.PHOTO_METADATAS);

// Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace())
final FetchPlaceRequest placeRequest = FetchPlaceRequest.newInstance(placeId, fields);

placesClient.fetchPlace(placeRequest).addOnSuccessListener((response) -> {
    final Place place = response.getPlace();

    // Get the photo metadata.
    final List<PhotoMetadata> metadata = place.getPhotoMetadatas();
    if (metadata == null || metadata.isEmpty()) {
        Log.w(TAG, "No photo metadata.");
        return;
    }
    final PhotoMetadata photoMetadata = metadata.get(0);

    // Get the attribution text.
    final String attributions = photoMetadata.getAttributions();

    // Create a FetchPhotoRequest.
    final FetchPhotoRequest photoRequest = FetchPhotoRequest.builder(photoMetadata)
        .setMaxWidth(500) // Optional.
        .setMaxHeight(300) // Optional.
        .build();
    placesClient.fetchPhoto(photoRequest).addOnSuccessListener((fetchPhotoResponse) -> {
        Bitmap bitmap = fetchPhotoResponse.getBitmap();
        imageView.setImageBitmap(bitmap);
    }).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.
        }
    });
});

      

Puedes usar un CancellationToken para intentar cancelar una solicitud a cualquiera de las clases de solicitudes (por ejemplo, FetchPlaceRequest). La cancelación se realiza según el criterio del mejor esfuerzo. Una vez que se emite una solicitud de cancelación, no se mostrará 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 la solicitud incluso si no se muestra ninguna respuesta.

Atribuciones

En la mayoría de los casos, las fotos de lugares se pueden usar sin atribución; de lo contrario, se incluirá la atribución requerida como parte de la imagen. Sin embargo, el objeto de metadatos de la foto, del tipo PhotoMetadata, puede contener cualquiera de estos dos tipos de atribuciones adicionales:

• Atribuciones, una string de atribución a la que accede PhotoMetadata.getAttributions().
• AuthorAttributions, un objeto AuthorAttributions al que accede PhotoMetadata.getAuthorAttributions().

Si el objeto PhotoMetadata que se muestra incluye cualquiera de los dos tipos de atribución, debes incluirla en tu aplicación en cualquier lugar en el que muestres la imagen. Para obtener más información, consulta Cómo mostrar atribuciones.

Uso y facturación

Se cobra un SKU Places Photo por las llamadas a fetchPhoto(). Consulta la página Uso y facturación para obtener más detalles.