Place Photos (nuevo)

Selecciona la plataforma: En Android iOS Servicio web

Place Photos (nuevo) te permite agregar contenido fotográfico de alta calidad a tus y mantener la integridad de su aplicación. Place Photos te brinda acceso a las millones de fotos almacenadas en la base de datos de Places. Place Photos muestra un URI a una imagen de mapa de bits. El mapa de bits un tamaño máximo de 4800 por 4800 píxeles.

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

Solicitudes de Place Photos

Para recuperar una imagen de un lugar, haz lo siguiente:

1. Usa Place Details (nuevo) para recuperar un objeto Place con fetchPlace() Asegúrate de incluir el campo Place.Field PHOTO_METADATAS en la lista de campos para incluir en el objeto Place de respuesta.
2. En la OnSuccessListener para tu FetchPlaceResponse, llama a Place.getPhotoMetadas() para obtener el objeto de metadatos de fotos de tipo PhotoMetadata del objeto Place de respuesta.
3. Crea un objeto FetchResolvedPhotoUriRequest para realizar la solicitud y pasar el objeto de metadatos de la foto, además de valores para la altura máxima, el ancho máximo o ambos.
4. Usa PlacesClient.fetchResolvedPhotoUri(). para solicitar el URI de la foto.
5. Agrega un elemento OnSuccessListener y obtén el URI de la foto de FetchResolvedPhotoUriResponse. .

Nota: Para obtener más información sobre cómo inicializar PlacesClient, consulta Inicializa el cliente de la API de Places.

Puedes usar un CancellationToken para intentar cancelar una solicitud a cualquiera de las clases de solicitud (por ejemplo, FetchPlaceRequest). La cancelación se realiza sobre la base 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 que una solicitud en particular se cancelará y es posible que se te cobre la solicitud incluso si no se muestra una respuesta inicial.

Parámetros obligatorios

Los parámetros obligatorios para FetchResolvedPhotoUriRequest son:

• Metadatos de fotos

  El objeto de metadatos de la foto que se mostrará.

• Altura o ancho máximos

  Especifica la altura y el ancho máximos (en píxeles) de la imagen que se mostrará. Si la imagen es más pequeña que los valores especificados, se devolverá la imagen original. Si la imagen es más grande en dimensión, se ajustará para que coincida con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original. Las propiedades de altura máxima y ancho máximo aceptan un número entero entre 1 y 4,800. Debes especificar la altura máxima, el ancho máximo o ambos.

  • Para establecer el parámetro de altura máxima, llama al método setMaxHeight() cuando compiles el objeto FetchResolvedPhotoUriRequest.
  • Para establecer el parámetro de ancho máximo, llama al método setMaxWidth() cuando compiles el objeto FetchResolvedPhotoUriRequest.

Ejemplos de Place Photos

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

// 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 and author attributions.
    final String attributions = photoMetadata.getAttributions();
    final AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();

    // Create a FetchResolvedPhotoUriRequest.
    final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata)
        .setMaxWidth(500)
        .setMaxHeight(300)
        .build();

    // Request the photo URI
    placesClient.fetchResolvedPhotoUri(photoRequest).addOnSuccessListener((fetchResolvedPhotoUriResponse) -> {
        Uri uri = fetchResolvedPhotoUriResponse.getUri();
        RequestOptions requestOptions = new RequestOptions().override(Target.SIZE_ORIGINAL);
        Glide.with(this).load(uri).apply(requestOptions).into(imageView);
    }).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.
        }
    });
});

Atribuciones

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

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

Si el objeto PhotoMetadata que se muestra incluye alguno de los tipos de atribución, debes hacer lo siguiente: incluye la atribución en tu aplicación en cualquier lugar en el que muestres la imagen. Para obtener más información, consulta Mostrar atribuciones.