Place Photos (legacy), parte dell'API Places, è un'API di sola lettura che ti consente di aggiungere contenuti fotografici di alta qualità alla tua applicazione. Place Photos (Legacy) ti consente di accedere a milioni di foto archiviate nel database di Places. Quando ottieni informazioni su un luogo utilizzando una richiesta Place Details, vengono restituite le referenze fotografiche per i contenuti fotografici pertinenti. Le richieste Find Place (legacy), Nearby Search (legacy) e Text Search (legacy) restituiscono anche un singolo riferimento fotografico per luogo, se pertinente. Utilizzando Place Photos (Legacy), puoi accedere alle foto a cui viene fatto riferimento e ridimensionare l'immagine alle dimensioni ottimali per la tua applicazione.
Richieste di Place Photos (legacy)
Una richiesta Place Photos (legacy) è un URL HTTP nel seguente formato:
https://maps.googleapis.com/maps/api/place/photo?parameters
Per avviare una richiesta di ricerca sono necessari determinati parametri. Come di consueto negli URL, tutti i parametri sono separati dal carattere e commerciale (&
). L'elenco dei parametri e dei relativi valori possibili è riportato di seguito.
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
maxheight or maxwidth
maxheight
specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.maxwidth
specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
Riferimenti fotografici
Tutte le richieste a Place Photos (legacy) devono includere un photo_reference
,
restituito nella risposta a una richiesta Find Place (legacy), Nearby Search (legacy),
Text Search (legacy) o Place Details (legacy). La risposta a queste
richieste conterrà un campo photos[]
se il luogo ha contenuti
fotografici correlati.
Nota:il numero di foto restituite varia in base alla richiesta.
- Una richiesta Trova luogo (legacy), Ricerca nelle vicinanze (legacy) o Ricerca di testo (legacy)
restituisce al massimo un elemento
photo
nell'array. - Una richiesta Places Details (legacy) restituisce fino a dieci elementi
photo
.
Ogni elemento photo
contiene i seguenti campi:
photo_reference
: una stringa utilizzata per identificare la foto quando esegui una richiesta di foto di un luogo (legacy).height
: l'altezza massima dell'immagine.width
: la larghezza massima dell'immagine.html_attributions[]
: contiene eventuali attribuzioni richieste. Questo campo sarà sempre presente, ma potrebbe essere vuoto.
Le foto restituite da Place Photos (legacy) provengono da varie posizioni,
tra cui proprietari di attività e foto inviate dagli utenti. Nella maggior parte dei casi, queste foto possono essere utilizzate senza attribuzione o l'attribuzione richiesta è inclusa nell'immagine. Tuttavia, se l'elemento photo
restituito
include un valore nel campo html_attributions
, devi includere
l'attribuzione aggiuntiva nella tua applicazione ovunque visualizzi l'immagine.
L'esempio seguente mostra una richiesta Place Details (legacy):
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
Di seguito è riportato un esempio dell'array photos[]
nella risposta.
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}]
...
Esempio di Place Photos (legacy)
Di seguito è riportata una richiesta di esempio. Questa richiesta restituisce l'immagine a cui viene fatto riferimento, ridimensionandola in modo che la larghezza sia al massimo di 400 pixel.
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
Risposta di Place Photos (legacy)
La risposta a una richiesta di foto dei luoghi (legacy) riuscita è un'immagine. Il tipo di immagine dipende dal tipo di foto inviata originariamente.
Se la tua richiesta supera la quota disponibile, il server restituisce uno stato HTTP 403 e mostra l'immagine seguente per indicare che la quota è stata superata:
Se il server non è in grado di comprendere la tua richiesta, restituisce lo stato HTTP 400, che indica una richiesta non valida. I motivi più comuni per una richiesta non valida includono:
- Il riferimento alla foto inviato non è stato specificato correttamente.
- La richiesta non includeva i parametri
maxwidth
omaxheight
. - Il valore del parametro
maxwidth
omaxheight
è stato impostato sunull
. - L'incentivo
photo_reference
è scaduto. Sephoto_reference
scade, invia una richiesta a Dettagli luogo (legacy), Trova luogo (legacy), Ricerca nelle vicinanze (legacy), o Ricerca di testo (legacy) per ottenere il valore aggiornato diphoto_reference
.