Place Photos (novo)

O Place Photos (novo) permite adicionar conteúdo fotográfico de alta qualidade ao seu aplicativo. O Place Photos oferece acesso a milhões de fotos armazenadas no banco de dados do Places. O Place Photos retorna um URI para uma imagem em bitmap. A imagem de bitmap tem um tamanho máximo de 4.800 por 4.800 pixels.

Observação :o Place Photos (novo) está disponível no SDK do Places para Android versão 3.4.0 e mais recentes. Para mais informações, consulte Escolher a versão do SDK.

Solicitações do Place Photos

Para recuperar uma imagem de um local:

1. Use Place Details (New) para buscar um objeto Place usando fetchPlace(). Inclua o campo Place.Field PHOTO_METADATAS na lista de campos a serem incluídos no objeto Place da resposta.
2. No OnSuccessListener do FetchPlaceResponse, chame Place.getPhotoMetadas() para receber o objeto de metadados da foto do tipo PhotoMetadata do objeto de resposta Place.
3. Crie um objeto FetchResolvedPhotoUriRequest para fazer a solicitação e transmitir o objeto de metadados da foto, além dos valores de altura máxima, largura máxima ou ambos.
4. Use PlacesClient.fetchResolvedPhotoUri() para solicitar o URI da foto.
5. Adicione uma OnSuccessListener e acesse o URI da foto do objeto FetchResolvedPhotoUriResponse.

Você pode usar um CancellationToken para tentar cancelar uma solicitação para qualquer uma das classes de solicitação (por exemplo, FetchPlaceRequest). O cancelamento é feito na medida do possível. Quando uma solicitação de cancelamento é emitida, nenhuma resposta é retornada. A emissão de um token de cancelamento NÃO garante que uma solicitação específica será cancelada. Além disso, você ainda poderá ser cobrado pela solicitação mesmo que nenhuma resposta seja retornada.

Parâmetros obrigatórios

Os parâmetros obrigatórios para FetchResolvedPhotoUriRequest são:

• Metadados da foto

  O objeto de metadados da foto a ser retornada.

• Altura ou largura máximas

  Especifica a altura e a largura máximas, em pixels, da imagem a ser retornada. Se a imagem for menor que os valores especificados, a imagem original será retornada. Se a imagem for maior em qualquer uma das dimensões, ela será redimensionada para corresponder à menor das duas dimensões, restrita à proporção original. Ambas as propriedades de altura e largura máxima aceitam um número inteiro entre 1 e 4.800. É necessário especificar a altura máxima, a largura máxima ou ambas.

  • Para definir o parâmetro de altura máxima, chame o método setMaxHeight() ao criar o objeto FetchResolvedPhotoUriRequest.
  • Para definir o parâmetro de largura máxima, chame o método setMaxWidth() ao criar o objeto FetchResolvedPhotoUriRequest.

Exemplos do Place Photos

O exemplo a seguir demonstra como obter um 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.
        }
    });
});

Atribuições

Na maioria dos casos, fotos de lugares podem ser usadas sem atribuição ou terão a atribuição necessária incluída na imagem. No entanto, o objeto de metadados de foto, do tipo PhotoMetadata, pode conter um destes dois tipos de atribuições adicionais:

• Attributions, uma string de atribuição acessada por PhotoMetadata.getAttributions().
• AuthorAttributions, um objeto AuthorAttributions acessado por PhotoMetadata.getAuthorAttributions().

Se o objeto PhotoMetadata retornado incluir qualquer tipo de atribuição, será necessário incluir a atribuição no aplicativo sempre que você mostrar a imagem. Para mais informações, consulte Exibição de atribuições.