Foto del luogo (legacy)

Sviluppatori dello Spazio economico europeo (SEE)

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 ai milioni di foto archiviate nel database di Places. Quando ricevi informazioni su un luogo utilizzando una richiesta Place Details, vengono restituiti riferimenti alle foto per i contenuti fotografici pertinenti. Le richieste Find Place (Legacy), Nearby Search (Legacy) e Ricerca testuale (Legacy) restituiscono anche un singolo riferimento foto per luogo, se pertinente. Utilizzando Place Photos (Legacy), puoi accedere alle foto di riferimento e ridimensionare l'immagine in modo che sia ottimale per la tua applicazione.

Richieste 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 alcuni 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.

Parametri obbligatori

  • photo_reference

    Un identificatore di stringa che identifica in modo univoco una foto. I riferimenti alle foto vengono restituiti da una richiesta Place Search o Place Details.

  • maxheight o maxwidth

    maxheight specifica l'altezza massima preferita, 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 modo da corrispondere alla dimensione più piccola, limitata alle proporzioni originali.

    maxwidth specifica la larghezza massima preferita dell'immagine in pixel. 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 modo da corrispondere alla dimensione più piccola delle due, limitata alle proporzioni originali.

    Entrambe le proprietà maxheight e maxwidth accettano un numero intero compreso tra 1 e 1600.

    Devi specificare maxheight o maxwidth o entrambi.

Riferimenti fotografici

Tutte le richieste a Place Photos (Legacy) devono includere un photo_reference, restituito nella risposta a una richiesta Trova luogo (Legacy), Nearby Search (Legacy), Ricerca testuale (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), Nearby Search (legacy) o Ricerca testuale (legacy) restituisce al massimo un elemento photo nell'array.
  • Una richiesta Place 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 Place Photos (Legacy).
  • height: l'altezza massima dell'immagine.
  • width: la larghezza massima dell'immagine.
  • html_attributions[]: contiene le attribuzioni obbligatorie. Questo campo sarà sempre presente, ma potrebbe essere vuoto.

Le foto restituite da Place Photos (Legacy) provengono da diverse fonti, tra cui i proprietari delle attività e le foto fornite dagli utenti. Nella maggior parte dei casi, queste foto possono essere utilizzate senza attribuzione o l'attribuzione richiesta verrà 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 mostri 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 è riportato un esempio di richiesta. Questa richiesta restituisce l'immagine di riferimento, ridimensionandola in modo che la sua 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 di una richiesta Place Photos (Legacy) riuscita è un'immagine. Il tipo di immagine dipende dal tipo di foto inviata originariamente.

Se la richiesta supera la quota disponibile, il server restituisce uno stato HTTP 403 e visualizza l'immagine seguente per indicare che la quota è stata superata:

Immagine per la quota superata

Se il server non è in grado di comprendere la richiesta, restituisce lo stato HTTP 400, che indica una richiesta non valida. I motivi più comuni di una richiesta non valida sono:

  • Il riferimento alla foto inviato non è stato specificato correttamente.
  • La richiesta non includeva i parametri maxwidth o maxheight.
  • Il valore del parametro maxwidth o maxheight è stato impostato su null.
  • L'incentivo photo_reference è scaduto. Se photo_reference scade, effettua una richiesta a Place Details (Legacy), Find Place (Legacy), Nearby Search (Legacy) o Text Search (Legacy) per ottenere il valore photo_reference aggiornato.