Photos du lieu

Sélectionnez une plate-forme: Android iOS JavaScript Service Web

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

Choisir le format de la photo

Le SDK Places pour Android accepte deux formats pour la photo demandée:

  • Toutes les versions du SDK Places pour Android:renvoie l'image bitmap. La taille maximale de l'image bitmap est de 1 600 x 1 600 pixels.
  • SDK Places pour Android (nouveau) version 3.4 ou ultérieure:renvoie un URI à l'image bitmap. La taille de l'image bitmap ne doit pas dépasser 4 800 x 4 800 pixels.

Processus de récupération des photos

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

  1. Utilisez Place Details pour récupérer un objet Place (utilisez fetchPlace() ou findCurrentPlace()). Veillez à 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 ou FindCurrentPlaceResponse :
    1. Utilisez Place.getPhotoMetadas() pour obtenir l'objet de métadonnées de photo, de type PhotoMetadata, à partir de l'objet Place de réponse.
    2. Pour obtenir une image bitmap:
      1. Créez un objet FetchPhotoRequest, en spécifiant éventuellement la hauteur et la largeur maximales (en pixels). La largeur ou la hauteur maximales des photos est de 1 600 pixels.
      2. Utilisez PlacesClient.fetchPhoto() pour demander le bitmap photo.
      3. Ajoutez un OnSuccessListener et récupérez la photo à partir de FetchPhotoResponse.
    3. Pour obtenir l'URI d'une photo:
      1. Créez un objet FetchResolvedPhotoUriRequest pour envoyer la requête. La largeur et la hauteur maximales des photos sont de 4 800 pixels.
      2. Utilisez PlacesClient.fetchResolvedPhotoUri() pour demander l'URI de la photo.
      3. Ajoutez un OnSuccessListener et obtenez l'URI de la photo à partir de l'objet FetchResolvedPhotoUriResponse.

Accéder aux données PhotoMetadata ajoutées à partir de la version 3.3.0

Le SDK Places pour Android (nouveau) ajoute le champ AuthorAttributions à la classe PhotoMetadata. Si votre application active le nouveau SDK, l'objet PhotoMetadata renvoyé par Place.getPhotoMetadas() peut contenir une ou plusieurs attributions d'auteurs.

Lorsque l'objet PhotoMetadata contient des attributions, qu'il s'agisse des nouvelles attributions d'auteurs ajoutées dans la version 3.3.0 ou des attributions existantes disponibles dans la version 3.2.0 et les versions antérieures, vous devez les afficher avec la photo. Pour en savoir plus sur la gestion de tous les types d'attributions, consultez Attributions.

Pour renseigner l'objet PhotoMetadata avec des attributions d'auteur, vous devez:

  1. Activez le nouveau SDK lorsque vous configurez votre projet Google Cloud.
  2. Initialisez le nouveau SDK dans une activité ou un fragment.
  3. Incluez Place.Field.PHOTO_METADATAS dans la liste de champs de la requête de détails de lieu.
  4. Appelez PlacesClient.fetchPlace() pour obtenir l'objet Place et Place.getPhotoMetadas() pour obtenir l'objet PhotoMetadata. Le champ des attributions d'auteur n'est pas compatible avec PlacesClient.findCurrentPlace().
  5. Utilisez PhotoMetadata.getAuthorAttributions() pour obtenir les attributions d'auteurs.

Prendre une photo

Cette section explique comment récupérer une photo en tant que bitmap ou URI.

Obtenir la photo d'un lieu au format bitmap

L'exemple suivant illustre l'obtention d'une photo de lieu sous forme de bitmap.

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

      

Obtenir l'URI d'une photo de lieu

L'exemple suivant montre comment obtenir l'URI d'une photo de lieu.

// 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 FetchResolvedPhotoUriRequest.
    final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata)
        .setMaxWidth(500) // Optional.
        .setMaxHeight(300) // Optional.
        .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.
        }
    });
});

Attributions

Dans la plupart des cas, les photos de lieu peuvent être utilisées sans attribution, ou l'attribution requise sera incluse dans l'image. Cependant, l'objet de métadonnées de photo, de type PhotoMetadata, peut contenir l'un des deux types d'attributions supplémentaires suivants:

Si l'objet PhotoMetadata renvoyé inclut l'un ou l'autre des types d'attribution, vous devez inclure celle-ci 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 faits à fetchPhoto(). Pour en savoir plus, consultez la page Utilisation et facturation.