Place Photos

Você pode usar o SDK do Places para Android para solicitar que uma foto de lugar seja exibida no seu aplicativo. As fotos retornadas pelo serviço de fotos vêm de várias fontes, incluindo proprietários de empresas e imagens enviadas pelos usuários.

O SDK do Places para Android retorna uma imagem bitmap com um tamanho máximo de 1600 x 1600 pixels.

Processo de recuperação de fotos

Para recuperar uma imagem de um lugar:

1. Use Detalhes do lugar para buscar um objeto Place (use fetchPlace() ou findCurrentPlace()). Inclua o campo Place.Field PHOTO_METADATAS na lista de campos a serem incluídos no objeto Place da resposta.
2. No OnSuccessListener para o FetchPlaceResponse ou FindCurrentPlaceResponse, use Place.getPhotoMetadas() para receber o objeto de metadados da foto, do tipo PhotoMetadata do objeto Place da resposta.
3. Crie um objeto FetchPhotoRequest, especificando opcionalmente a altura e a largura máximas (em pixels). As fotos podem ter largura ou altura máxima de 1.600 px.
4. Use PlacesClient.fetchPhoto() para solicitar o bitmap da foto.
5. Adicione um OnSuccessListener e receba a foto do FetchPhotoResponse.

Receber uma foto

O exemplo a seguir demonstra como conseguir uma foto de um lugar:

KotlinJava

// 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.")
                }
            }
    }

      

// 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.
        }
    });
});

      

Observação:para mais informações sobre como inicializar PlacesClient, consulte Inicializar o cliente da API Places.

É possível usar um CancellationToken para tentar cancelar uma solicitação para qualquer uma das classes de solicitação (por exemplo, FetchPlaceRequest). O cancelamento é feito da melhor forma possível. Depois que uma solicitação de cancelamento é emitida, nenhuma resposta é retornada. Emitir um token de cancelamento NÃO garante que uma solicitação específica seja cancelada, e você ainda pode ser cobrado pela solicitação, mesmo que nenhuma resposta seja retornada.

Atribuições

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

• Atribuições, 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 seu aplicativo sempre que você mostrar a imagem. Para mais informações, consulte Exibir atribuições.

Uso e faturamento

Uma SKU do Places Photo é cobrada nas chamadas para fetchPhoto(). Consulte a página Uso e faturamento para mais detalhes.