Method: places.photos.getMedia

Recupera un elemento multimediale di una foto con una stringa di riferimento alla foto.

Richiesta HTTP

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della risorsa di un elemento multimediale di una foto nel formato: places/{placeId}/photos/{photo_reference}/media.

Il nome della risorsa di una foto restituito nel campo photos.name di un oggetto Place ha il formato places/{placeId}/photos/{photo_reference}. Devi aggiungere /media alla fine della risorsa foto per ottenere il nome della risorsa multimediale della foto.

Parametri di query

Parametri
maxWidthPx

integer

Facoltativo. Specifica la larghezza massima desiderata, in pixel, dell'immagine. Se l'immagine è più piccola dei valori specificati, verrà restituita l'immagine originale. Se l'immagine è più grande in una delle due dimensioni, verrà scalata in modo da corrispondere alla più piccola delle due dimensioni, limitata alle proporzioni originali. Le proprietà maxHeightPx e maxWidthPx accettano un numero intero compreso tra 1 e 4800, inclusi. Se il valore non rientra nell'intervallo consentito, verrà restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno una delle proprietà maxHeightPx o maxWidthPx. Se non viene specificata né maxHeightPx né maxWidthPx, verrà restituito un errore INVALID_ARGUMENT.
maxHeightPx

integer

Facoltativo. Specifica l'altezza massima desiderata, in pixel, dell'immagine. Se l'immagine è più piccola dei valori specificati, verrà restituita l'immagine originale. Se l'immagine è più grande in una delle due dimensioni, verrà scalata in modo da corrispondere alla più piccola delle due dimensioni, limitata alle proporzioni originali. Le proprietà maxHeightPx e maxWidthPx accettano un numero intero compreso tra 1 e 4800, inclusi. Se il valore non rientra nell'intervallo consentito, verrà restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno una delle proprietà maxHeightPx o maxWidthPx. Se non viene specificata né maxHeightPx né maxWidthPx, verrà restituito un errore INVALID_ARGUMENT.
skipHttpRedirect

boolean

Facoltativo. Se impostato, salta il comportamento di reindirizzamento HTTP predefinito ed esegui il rendering di una risposta in formato di testo (ad esempio, in formato JSON per il caso d'uso HTTP). Se non è impostato, verrà emesso un reindirizzamento HTTP per reindirizzare la chiamata all'elemento multimediale dell'immagine. Questa opzione viene ignorata per le richieste non HTTP.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Un elemento multimediale di una foto dell'API Places.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "name": string,
  "photoUri": string
}
Campi
name

string

Il nome della risorsa di un elemento multimediale di una foto nel formato: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

Un URI di breve durata che può essere utilizzato per il rendering della foto.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform