Place Photos (novo)

Selecione a plataforma: Android iOS Serviço da Web

O Place Photos (novo) permite adicionar conteúdo fotográfico de alta qualidade ao seu aplicativo. O Place Photos dá acesso a milhões de fotos armazenadas no banco de dados do Places. O Place Photos retorna um URI para uma imagem de bitmap. A imagem em 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 3.4.0 e versões mais recentes. Para mais informações, consulte Escolher a versão do SDK.

Solicitações do Place Photos

Para recuperar a imagem de um lugar:

1. Use Place Details (novo) 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 de resposta.
2. No OnSuccessListener da FetchPlaceResponse, chame Place.getPhotoMetadas() para receber o objeto de metadados de foto do tipo PhotoMetadata do objeto de resposta Place.
3. Crie um objeto FetchResolvedPhotoUriRequest para fazer a solicitação e transmita o objeto de metadados da foto, bem como os valores de altura máxima, largura máxima ou ambos.
4. Use PlacesClient.fetchResolvedPhotoUri() para solicitar o URI da foto.
5. Adicione um OnSuccessListener e receba 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. Você ainda poderá receber cobranças 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 máxima ou largura máxima

  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 uma das dimensões, ela será redimensionada para corresponder à menor das duas dimensões, restrita à proporção original. As propriedades de altura máxima e largura máxima aceitam um número inteiro entre 1 e 4.800. Você precisa 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 conseguir um URI de foto de local.

// 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, as 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 fotos, do tipo PhotoMetadata, pode conter um destes dois tipos de atribuições extras:

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

Se o objeto PhotoMetadata retornado incluir um dos tipos de atribuição, será necessário incluir a atribuição no seu aplicativo sempre que você mostrar a imagem. Para mais informações, consulte Exibir atribuições.