Photos du lieu

Développeurs de l'Espace économique européen (EEE)

Si votre adresse de facturation se trouve dans l'Espace économique européen, les Conditions d'utilisation de Google Maps Platform pour l'EEE s'appliqueront à votre utilisation des Services à compter du 8 juillet 2025. La fonctionnalité varie selon la région. En savoir plus

Vous pouvez utiliser le SDK Places pour Android afin de demander une photo de lieu à afficher dans votre application. Les photos renvoyées par le service Photos proviennent de diverses sources, y compris des propriétaires d'établissement et des photos fournies par les utilisateurs.

Le SDK Places pour Android renvoie une image bitmap d'une taille maximale de 1 600 x 1 600 pixels.

Processus de récupération de photos

Pour récupérer une image d'un lieu :

1. Utilisez Place Details pour récupérer un objet Place (à l'aide de fetchPlace()). Assurez-vous d'inclure le champ Place.Field PHOTO_METADATAS dans la liste des champs à inclure dans l'objet Place de la réponse.
2. Dans le OnSuccessListener de votre FetchPlaceResponse, utilisez Place.getPhotoMetadas() pour obtenir l'objet de métadonnées photo, de type PhotoMetadata, à partir de l'objet de réponse Place.
3. Créez un objet FetchPhotoRequest, en spécifiant éventuellement la hauteur et la largeur maximales (en pixels). La largeur ou la hauteur des photos ne doit pas dépasser 1 600 pixels.
4. Utilisez PlacesClient.fetchPhoto() pour demander le bitmap de la photo.
5. Ajoutez un OnSuccessListener et obtenez la photo à partir de FetchPhotoResponse.

Obtenir une photo

L'exemple suivant montre comment obtenir une photo d'un lieu :

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

      

Remarque : Pour en savoir plus sur l'initialisation de PlacesClient, consultez Initialiser le client de l'API Places.

Vous pouvez utiliser un CancellationToken pour tenter d'annuler une requête à l'une des classes de requête (par exemple, FetchPlaceRequest). L'annulation est effectuée au mieux. Une fois la demande d'annulation émise, aucune réponse ne sera renvoyée. L'émission d'un jeton d'annulation ne garantit PAS qu'une requête particulière sera annulée. Vous pouvez toujours être facturé pour la requête, même si aucune réponse n'est renvoyée.

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 AuthorAttributions auquel on accède par PhotoMetadata.getAuthorAttributions().

Si l'objet PhotoMetadata renvoyé inclut l'un ou l'autre de ces types d'attribution, vous devez l'inclure dans votre application partout où vous affichez l'image. Pour en savoir plus, consultez Afficher les attributions.

Utilisation et facturation

Un SKU Places Photo est facturé pour les appels à fetchPhoto(). Pour en savoir plus, consultez la page Utilisation et facturation.