Foto del luogo

Seleziona 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 consente di accedere ai milioni di foto archiviate nel database di Places. Quando ricevi informazioni sul luogo tramite una richiesta Dettagli luogo, vengono restituiti riferimenti a foto per contenuti fotografici pertinenti. Le richieste Trova luogo, Ricerca nelle vicinanze e Ricerca testo restituiscono anche un singolo riferimento a foto per luogo, se pertinente. Grazie al servizio Foto potrai accedere alle foto di riferimento e ridimensionare l'immagine in base alle dimensioni ottimali per la tua applicazione.

Richieste di foto del luogo

Una richiesta Foto luogo è 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 per gli URL, tutti i parametri sono separati utilizzando la e commerciale (&). L'elenco dei parametri e i relativi valori possibili sono elencati 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.

Optional parameters

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

  • 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.

Generated from the OpenAPI specification. Edit Report bug

Riferimenti a foto

Tutte le richieste inviate al servizio Foto del luogo devono includere un elemento photoreference, restituito nella risposta a una richiesta Trova luogo, Ricerca nelle vicinanze, Ricerca testo 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 in base alla richiesta.

  • Una richiesta Trova luogo, Ricerca nelle vicinanze o Ricerca testuale restituisce al massimo un elemento photo nell'array.
  • Una richiesta Dettagli luogo restituisce fino a dieci elementi photo.

Ogni elemento photo conterrà 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 tutte le attribuzioni richieste. Questo campo sarà sempre presente, ma potrebbe essere vuoto.

Le foto restituite dal servizio Foto provengono da diverse località, tra cui proprietari di attività e foto fornite dagli utenti. Nella maggior parte dei casi, queste foto possono essere utilizzate senza attribuzione o includeranno l'attribuzione richiesta come parte dell'immagine. Tuttavia, se l'elemento photo restituito include un valore nel campo html_attributions, devi includere l'attribuzione aggiuntiva nell'applicazione ovunque mostri l'immagine.

Di seguito è riportato un esempio di array photos[].

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Esempio di foto del luogo

Di seguito è riportato un esempio di richiesta. Questa richiesta restituisce l'immagine di riferimento, ridimensionandola in modo che sia larga al massimo 400 pixel.

https://maps.googleapis.com/maps/api/place/photo
  ?maxwidth=400
  &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT
  &key=YOUR_API_KEY

Risposta per luogo foto

La risposta a una richiesta di Foto correttamente eseguita sarà un'immagine. Il tipo di immagine dipende dal tipo di foto inviata inizialmente.

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 per superamento quota

Se il server non riesce a comprendere la richiesta, restituisce lo stato HTTP 400, che indica una richiesta non valida. I motivi più comuni per una richiesta non valida sono:

  • Il riferimento della 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.