Method: places.photos.getMedia

Ottieni un elemento multimediale della foto con una stringa di riferimento per la 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 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 rispetto ai 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 è compreso nell'intervallo consentito, verrà restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno uno tra maxHeightPx o maxwidthPx. Se non viene specificato 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 rispetto ai 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 è compreso nell'intervallo consentito, verrà restituito un errore INVALID_ARGUMENT.

È necessario specificare almeno uno tra maxHeightPx o maxwidthPx. Se non viene specificato né maxHeightPx né maxwidthPx, verrà restituito un errore INVALID_ARGUMENT.

skipHttpRedirect

boolean

(Facoltativo) Se impostato, ignora il comportamento di reindirizzamento HTTP predefinito e visualizza una risposta in formato di testo (ad esempio in formato JSON per il caso d'uso HTTP). Se non viene configurato, viene generato 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 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 supporto fotografico 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.