Vous pouvez utiliser le SDK Places pour Android (ancien) pour demander une photo de lieu à afficher dans votre application. Les photos renvoyées par le service Photo sont extraites de plusieurs sources : elles peuvent être fournies par des propriétaires d'établissement ou par des utilisateurs.
Le SDK Places pour Android (ancien) renvoie une image bitmap d'une taille maximale de 1 600 x 1 600 pixels.
Processus de récupération des photos
Pour récupérer une image d'un lieu :
- Utilisez Place Details (Legacy) pour récupérer un objet
Place(à l'aide defetchPlace()). Veillez à inclure le champPlace.Field PHOTO_METADATASdans la liste des champs à inclure dans l'objetPlacede la réponse. - Dans
OnSuccessListenerpour votreFetchPlaceResponse, utilisezPlace.getPhotoMetadas()pour obtenir l'objet de métadonnées de la photo, de typePhotoMetadata, à partir de l'objetPlacede la réponse. - Créez un objet
FetchPhotoRequest, en spécifiant éventuellement la hauteur et la largeur maximales (en pixels). La largeur ou la hauteur maximale des photos est de 1 600 pixels. - Utilisez
PlacesClient.fetchPhoto()pour demander le bitmap de la photo. - Ajoutez un
OnSuccessListeneret récupérez la photo à partir deFetchPhotoResponse.
Prendre une photo
L'exemple suivant montre comment obtenir une photo de lieu :
Kotlin
// Define a Place ID. val placeId = PlaceIdProvider.getRandomPlaceId() // 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 metadata = place.photoMetadatas if (metadata == null || metadata.isEmpty()) { Log.w(TAG, "No photo metadata.") return@addOnSuccessListener } val photoMetadata = metadata.first() // Get the attribution text. val attributions = photoMetadata?.attributions binding.placePhotosAttributions.text = attributions // Create a FetchResolvedPhotoUriRequest. val photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build() placesClient.fetchResolvedPhotoUri(photoRequest) .addOnSuccessListener { fetchPhotoResponse -> val photoUri = fetchPhotoResponse.uri Glide.with(this) .load(photoUri) .into(binding.placePhotosResult) }.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 = PlaceIdProvider.getRandomPlaceId(); // 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(); binding.placePhotosAttributions.setText(attributions); // Create a FetchResolvedPhotoUriRequest. final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build(); placesClient .fetchResolvedPhotoUri(photoRequest) .addOnSuccessListener( (fetchPhotoResponse) -> { Glide.with(this) .load(fetchPhotoResponse.getUri()) .into(binding.placePhotosResult); }) .addOnFailureListener( (exception) -> { if (exception instanceof ApiException) { ApiException apiException = (ApiException) exception; Log.e( TAG, "Place not found: " + exception.getMessage()); final int statusCode = apiException.getStatusCode(); // TODO: Handle error with given status code. } }); });
Attributions
Dans la plupart des cas, les photos de lieu peuvent être utilisées sans attribution, ou contiendront déjà l'attribution. Toutefois, l'objet de métadonnées de photo, de type PhotoMetadata, peut contenir l'un des deux types d'attributions supplémentaires suivants :
- Attributions : chaîne d'attribution accessible par
PhotoMetadata.getAttributions(). - AuthorAttributions, un objet
AuthorAttributionsaccessible parPhotoMetadata.getAuthorAttributions().
Si l'objet PhotoMetadata renvoyé inclut l'un ou l'autre type d'attribution, vous devez inclure l'attribution dans votre application partout où vous affichez l'image. Pour en savoir plus, consultez Afficher les attributions.
Utilisation et facturation
Un SKU Place Photos (ancien) est facturé pour les appels à fetchPhoto().
Pour en savoir plus, consultez la page Utilisation et facturation.