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 file multimediale di 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à ridimensionata in base alla dimensione più piccola, rispettando le 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 una delle due dimensioni, verrà ridimensionata in base alla dimensione più piccola, rispettando le 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.
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 file multimediale di foto dall'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 visualizzare la foto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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