Foto del luogo (novità)

Seleziona piattaforma:Android iOS Servizio web

Sviluppatori dello Spazio economico europeo (SEE)

Se il tuo indirizzo di fatturazione si trova nello Spazio economico europeo, a partire dall'8 luglio 2025, i Termini di servizio di Google Maps Platform per il SEE si applicheranno al tuo utilizzo dei Servizi. La funzionalità varia in base alla regione. Scopri di più.

Place Photos (New) ti consente di aggiungere contenuti fotografici di alta qualità alla tua applicazione. Foto del luogo ti consente di accedere a milioni di foto archiviate nel database di Places. Place Photos restituisce un URI a un'immagine bitmap. L'immagine bitmap ha una dimensione massima di 4800 x 4800 pixel.

Nota :Place Photos (New) è disponibile in Places SDK for Android versione 3.4.0 e successive. Per saperne di più, vedi Scegliere la versione dell'SDK. Per ulteriori informazioni sull'utilizzo delle API Kotlin aggiunte nella versione 4.0.0, consulta la panoramica dei riferimenti.

Richieste di foto del luogo

Per recuperare un'immagine di un luogo:

1. Utilizza Dettagli luogo (nuovo) per recuperare un oggetto Place utilizzando fetchPlace(). Assicurati di includere il campo Place.Field PHOTO_METADATAS nell'elenco dei campi da includere nell'oggetto Place della risposta.
2. Nel OnSuccessListener per il tuo FetchPlaceResponse, chiama Place.getPhotoMetadas() per ottenere l'oggetto dei metadati della foto di tipo PhotoMetadata dall'oggetto Place della risposta.
3. Crea un oggetto FetchResolvedPhotoUriRequest per effettuare la richiesta e trasmettere l'oggetto metadati della foto, nonché i valori per l'altezza massima, la larghezza massima o entrambi.
4. Utilizza PlacesClient.fetchResolvedPhotoUri() per richiedere l'URI della foto.
5. Aggiungi un OnSuccessListener e ottieni l'URI della foto dall'oggetto FetchResolvedPhotoUriResponse.

Nota: per ulteriori informazioni sull'inizializzazione di PlacesClient, consulta Inizializzare il client dell'API Places.

Puoi utilizzare un CancellationToken per tentare di annullare una richiesta a una delle classi di richiesta (ad esempio, FetchPlaceRequest). L'annullamento viene eseguito in base al criterio del "best effort". Una volta emessa una richiesta di annullamento, non verrà restituita alcuna risposta. L'emissione di un token di annullamento NON garantisce che una determinata richiesta verrà annullata e potresti comunque ricevere un addebito per la richiesta anche se non viene restituita alcuna risposta.

Parametri obbligatori

I parametri obbligatori per FetchResolvedPhotoUriRequest sono:

• Metadati delle foto

  L'oggetto dei metadati della foto da restituire.

• Altezza massima o larghezza massima

  Specifica l'altezza e la larghezza massime, in pixel, dell'immagine da restituire. Se l'immagine è più piccola dei valori specificati, verrà restituita l'immagine originale. Se l'immagine è più grande in una delle due dimensioni, verrà ridimensionata in modo che corrisponda alla più piccola delle due dimensioni, mantenendo le proporzioni originali. Entrambe le proprietà di altezza massima e larghezza massima accettano un numero intero compreso tra 1 e 4800. Devi specificare l'altezza massima, la larghezza massima o entrambe.

  • Per impostare il parametro di altezza massima, chiama il metodo setMaxHeight() durante la creazione dell'oggetto FetchResolvedPhotoUriRequest.
  • Per impostare il parametro di larghezza massima, chiama il metodo setMaxWidth() durante la creazione dell'oggetto FetchResolvedPhotoUriRequest.

Esempi di Place Photos

L'esempio seguente mostra come ottenere un URI di una foto di un luogo.

// 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 and author attributions.
    final String attributions = photoMetadata.getAttributions();
    final AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();

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

Attribuzioni

Nella maggior parte dei casi, le foto dei luoghi possono essere utilizzate senza attribuzione o con l'attribuzione richiesta inclusa nell'immagine. Tuttavia, l'oggetto metadati della foto, di tipo PhotoMetadata, può contenere uno dei due tipi di attribuzioni aggiuntive:

• Attribuzioni, una stringa di attribuzione a cui si accede tramite PhotoMetadata.getAttributions().
• AuthorAttributions, un oggetto AuthorAttributions a cui si accede tramite PhotoMetadata.getAuthorAttributions().

Se l'oggetto PhotoMetadata restituito include uno dei due tipi di attribuzione, devi includerla nella tua applicazione ovunque visualizzi l'immagine. Per ulteriori informazioni, vedi Visualizzazione delle attribuzioni.