Foto del luogo

Seleziona la piattaforma: Android iOS JavaScript Servizio web

Il servizio Place Photo, parte dell'API Places, è un'API di sola lettura che ti consente di aggiungere contenuti fotografici di alta qualità alla tua applicazione. Il servizio Place Photo ti permette di accedere ai milioni di foto memorizzate nel database di Places. Quando ottieni le informazioni sul luogo tramite una richiesta Dettagli luogo, verranno restituiti i riferimenti fotografici per i contenuti fotografici pertinenti. Le richieste Trova luogo, Ricerca nelle vicinanze e Ricerca testuale restituiscono anche un unico riferimento con foto per luogo, se pertinente. Utilizzando il servizio Foto puoi quindi accedere alle foto di riferimento e ridimensionare l'immagine secondo le dimensioni ottimali per la tua applicazione.

Effettua richieste di foto

Una richiesta di Place Photo è un URL HTTP nel seguente formato:

https://maps.googleapis.com/maps/api/place/photo?parameters

Alcuni parametri sono necessari per avviare una richiesta di ricerca. Come standard negli URL, tutti i parametri sono separati mediante la e commerciale (&). Di seguito è riportato l'elenco dei parametri e dei relativi valori possibili.

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 and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, or both.

Riferimenti foto

Tutte le richieste al servizio Foto del luogo devono includere un photo_reference, restituito in risposta a una richiesta Trova luogo, Ricerca nelle vicinanze, Ricerca testuale o Dettagli luogo. La risposta a queste richieste conterrà un campo photos[] se il luogo ha contenuti fotografici correlati.

Nota: il numero di foto restituite varia a seconda della richiesta.

  • Una richiesta Trova luogo, Nearby Search o Text Search restituisce al massimo un elemento photo nell'array.
  • Una richiesta Place Details 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.
  • height: l'altezza massima dell'immagine.
  • width: la larghezza massima dell'immagine.
  • html_attributions[]: contiene le attribuzioni richieste. Questo campo sarà sempre presente, ma potrebbe essere vuoto.

Le foto restituite dal servizio Foto provengono da vari luoghi, tra cui le foto dei proprietari di attività e quelle fornite dagli utenti. Nella maggior parte dei casi, queste foto possono essere utilizzate senza attribuzione o avranno 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 mostri l'immagine.

.

L'esempio seguente mostra una richiesta Dettagli luogo:

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 Photo

Di seguito è riportato un esempio di richiesta. Questa richiesta restituirà l'immagine di riferimento, ridimensionandola in modo che abbia una larghezza massima di 400 pixel.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

Inserisci la risposta della foto

La risposta corretta per una richiesta di foto del luogo sarà un'immagine. Il tipo dell'immagine dipenderà dal tipo di foto inviata in origine.

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

Immagine di superamento quota

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 di una richiesta non valida includono:

  • Il riferimento 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.
  • Il documento photo_reference è scaduto. Se photo_reference scade, invia una richiesta a Dettagli luogo, Trova luogo, Ricerca nelle vicinanze o Ricerca di testo per ottenere il valore photo_reference aggiornato.