Method: places.photos.getMedia

Ottieni un supporto fotografico con una stringa di riferimento fotografica.

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}. Per ottenere il nome della risorsa multimediale fotografica, devi aggiungere /media alla fine della risorsa foto.

Parametri di ricerca

Parametri
maxWidthPx

integer

Campo 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 per adattarsi alla dimensione più piccola tra le due, limitando le proporzioni originali. Entrambe le proprietà maxHeightPx e maxLarghezzaPx 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 un valore tra maxHeightPx o maxLarghezzaPx. Se non vengono specificati né maxHeightPx né maxLarghezzaPx, verrà restituito un errore INVALID_gnam.

maxHeightPx

integer

Campo 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 per adattarsi alla dimensione più piccola tra le due, limitando le proporzioni originali. Entrambe le proprietà maxHeightPx e maxLarghezzaPx 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 un valore tra maxHeightPx o maxLarghezzaPx. Se non vengono specificati né maxHeightPx né maxLarghezzaPx, verrà restituito un errore INVALID_gnam.

skipHttpRedirect

boolean

Campo 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, verrà generato un reindirizzamento HTTP per reindirizzare la chiamata al supporto 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 fotografico 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 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.