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 a milioni di foto archiviate nel database di Places. Quando si ottengono informazioni su un luogo tramite una richiesta di Dettagli luogo, verranno restituiti riferimenti fotografici per i contenuti fotografici pertinenti. Anche le richieste Trova luogo (Legacy), Ricerca nelle vicinanze (Legacy) e Ricerca di testo (Legacy) restituiscono un singolo riferimento fotografico per luogo, quando pertinente. Utilizzando Place Photos (Legacy) puoi quindi accedere alle foto di riferimento e ridimensionare l'immagine alla dimensione ottimale per la tua applicazione.

Richieste di foto di luoghi (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 standard negli URL, tutti i parametri sono separati dal carattere e commerciale (&). Di seguito è riportato l'elenco dei parametri e dei loro possibili valori.

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 fotografici

Tutte le richieste di Posizionamento foto (Legacy) devono includere un photo_reference, restituito nella risposta a una richiesta Trova luogo (Legacy), Ricerca nelle vicinanze (Legacy), Ricerca di testo (Legacy) o Dettagli luogo (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 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 si esegue una richiesta Place Photos (Legacy).
  • height: l'altezza massima dell'immagine.
  • width: la larghezza massima dell'immagine.
  • html_attributions[] — contiene tutte le 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 è riportato un esempio di richiesta. Questa richiesta restituisce l'immagine a cui viene fatto 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

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 riportata di seguito per indicare che la quota è stata superata:

Immagine di quota 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: