Method: places.photos.getMedia

Recupera un file multimediale con una stringa di riferimento della 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 supporto fotografico 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 fotografica per recuperarne il nome.

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 entrambe le dimensioni, verrà ridimensionata in modo da corrispondere alla più piccola delle due dimensioni, limitatamente alle proporzioni originali. Entrambe le proprietà maxHeightPx e maxwidthPx accettano un numero intero compreso tra 1 e 4800 inclusi. Se il valore non rientra nell'intervallo consentito, viene restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno uno tra maxHeightPx o maxWidthPx. Se non vengono specificati né maxHeightPx né maxWidthPx, viene 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 entrambe le dimensioni, verrà ridimensionata in modo da corrispondere alla più piccola delle due dimensioni, limitatamente alle proporzioni originali. Sia la proprietà maxHeightPx sia la proprietà maxWidthPx accettano un numero intero compreso tra 1 e 4800, inclusi. Se il valore non rientra nell'intervallo consentito, viene restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno uno tra maxHeightPx o maxWidthPx. Se non vengono specificati né maxHeightPx né maxWidthPx, viene restituito un errore INVALID_ARGUMENT.
skipHttpRedirect

boolean

(Facoltativo) Se impostato, salta il comportamento predefinito del reindirizzamento HTTP e mostra 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 ai contenuti multimediali 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 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 file multimediale di foto nel formato: places/{placeId}/photos/{photo_reference}/media.
photoUri

string

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