Photos du lieu

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

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 d'un diverses sources, y compris les propriétaires d'établissement et les photos fournies par les utilisateurs.

Le SDK Places pour Android renvoie une image bitmap avec une valeur de 1 600 x 1 600 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 pour inclure dans l'objet Place de la réponse.
2. Dans OnSuccessListener pour votre FetchPlaceResponse ou FindCurrentPlaceResponse, utilisez Place.getPhotoMetadas() pour obtenir l'objet de métadonnées de photo, de type PhotoMetadata. à partir de l'objet de réponse Place.
3. Créez un objet FetchPhotoRequest. Vous pouvez éventuellement spécifier une hauteur et une largeur maximales (en pixels). Les photos peuvent contenir d'une largeur ou d'une hauteur maximale de 1 600 pixels.
4. Utiliser PlacesClient.fetchPhoto() pour demander le bitmap de la photo.
5. Ajoutez un élément OnSuccessListener et récupérez la photo à partir de FetchPhotoResponse

Obtenir une photo

L'exemple suivant illustre l'obtention d'une photo de 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 Initialisez le client de l'API Places.

Vous pouvez utiliser un CancellationToken. pour tenter d'annuler une requête adressée à l'une des classes de requête (par exemple, FetchPlaceRequest). La résiliation est effectuée dans la mesure du possible. Lorsqu'une demande d'annulation est envoyée, aucune réponse n'est renvoyée. L'émission d'un jeton d'annulation ne garantit PAS qu'une demande particulière est annulé. Il se peut que la demande soit débitée, même si vous n'avez pas est renvoyée.

Attributions

Dans la plupart des cas, les photos de lieu peuvent être utilisées sans attribution, ou contiendront l'attribution obligatoire 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:

• Attributions, une chaîne d'attribution à laquelle les utilisateurs peuvent accéder PhotoMetadata.getAttributions()
• AuthorAttributions, une AuthorAttributions objet auquel accède PhotoMetadata.getAuthorAttributions().

Si l'objet PhotoMetadata renvoyé inclut l'un ou l'autre des types d'attributions, vous devez Incluez l'attribution dans votre application, partout où vous affichez l'image. Pour plus d'informations, consultez la section 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.