Foto del luogo

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.
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à all'applicazione. Il servizio Foto del posto ti consente di accedere ai milioni di foto archiviate nel database di Places. Quando ricevi informazioni sul luogo utilizzando una richiesta Dettagli luogo, vengono restituiti riferimenti fotografici per i contenuti fotografici pertinenti. Le richieste Trova luoghi, Ricerca nelle vicinanze e Ricerca di testo restituiscono anche un singolo riferimento foto per luogo, se pertinente. Utilizzando il servizio Foto puoi accedere alle foto a cui viene fatto riferimento e ridimensionare l'immagine alle dimensioni ottimali per la tua applicazione.

Richieste di aggiungere foto

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 accade per gli URL, tutti i parametri sono separati con la e commerciale (&). L'elenco di 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

Foto di riferimento

Tutte le richieste al servizio Foto del luogo devono includere un elemento photoreference, restituito nella risposta a una richiesta Trova luogo, Ricerca nelle vicinanze, Ricerca di 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 a seconda della 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 le eventuali attribuzioni richieste. Questo campo sarà sempre presente, ma potrebbe essere vuoto.

Le foto restituite dal servizio Foto provengono da una serie di posizioni, 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 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 ogni volta che visualizzi 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 di un luogo

Di seguito è riportato un esempio di richiesta. Questa richiesta restituirà 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 di una richiesta effettuata con Foto è 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 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 per 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.