Você pode usar o SDK do Places para Android e solicitar uma foto de lugar para exibir no seu aplicativo. Fotos retornadas pelo serviço de fotos vêm de várias fontes, incluindo proprietários de empresas e fotos enviadas pelos usuários. Para recuperar uma imagem de um local, siga estas etapas:
- Use Place Details para buscar um objeto
Place
(usefetchPlace()
oufindCurrentPlace()
). Inclua o campoPlace.Field PHOTO_METADATAS
na lista de campos a serem incluídos no objetoPlace
da resposta. - No
OnSuccessListener
doFetchPlaceResponse
ouFindCurrentPlaceResponse
:- Use
Place.getPhotoMetadas()
para receber o objeto de metadados de foto do tipoPhotoMetadata
do objetoPlace
de resposta. - Crie um objeto
FetchPhotoRequest
, especificando a altura e a largura máximas (em pixels). As fotos podem ter uma largura ou altura máxima de 1.600 pixels. - Use
PlacesClient.fetchPhoto()
para solicitar a foto. - Adicione uma
OnSuccessListener
e receba a foto daFetchPhotoResponse
.
- Use
Acessar dados de PhotoMetadata adicionados na versão 3.3.0.
O SDK do Places para Android (novo) adiciona o campo AuthorAttributions
à classe PhotoMetadata
. Se o app ativar o novo SDK, o
objeto PhotoMetadata
retornado por Place.getPhotoMetadas()
poderá conter uma
ou mais atribuições de autor.
Quando o objeto PhotoMetadata
contém atribuições, as novas atribuições de autor
adicionadas na versão 3.3.0 ou as atribuições existentes disponíveis na versão 3.2.0 e
anteriores precisam ser exibidas com a foto. Para mais informações sobre como lidar com todos os tipos de
atribuições, consulte Atribuições.
Para preencher o objeto PhotoMetadata
com atribuições de autor, você precisa:
- Ative o novo SDK quando você configurar seu projeto do Google Cloud.
- Inicialize o novo SDK em uma atividade ou um fragmento.
- Inclua o
Place.Field.PHOTO_METADATAS
na lista de campos da solicitação do Place Details. - Chame
PlacesClient.fetchPlace()
para receber o objetoPlace
ePlace.getPhotoMetadas()
para receber o objetoPhotoMetadata
. O campo de atribuições do autor não é compatível comPlacesClient.findCurrentPlace()
. - Use
PhotoMetadata.getAuthorAttributions()
para receber atribuições de autor.
Tirar uma foto de lugar
O exemplo a seguir demonstra como obter uma foto de local.
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. } }); });
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 como parte da imagem. No entanto, o objeto de metadados da 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 porPhotoMetadata.getAuthorAttributions()
.
Se o objeto PhotoMetadata
retornado incluir qualquer tipo de atribuição, será necessário
incluí-la no aplicativo sempre que você exibir a imagem. Para mais informações, consulte Exibir atribuições.
Uso e faturamento
Uma SKU do Places Photo é cobrada pelas chamadas para fetchPhoto()
.
Consulte a página Uso e faturamento para mais detalhes.