Foto del luogo

Seleziona la piattaforma: Android iOS JavaScript Servizio web

Il servizio Place Photo, parte dell'API Places, è una piattaforma l'unica API che consente di aggiungere contenuti fotografici di alta qualità ai tuoi un'applicazione. Il servizio Place Photo ti dà accesso a milioni di foto nel database di Places. Quando ricevi informazioni su un luogo utilizzando un luogo Richiesta di dettagli; verranno restituiti riferimenti fotografici per la fotografia pertinente contenuti. Anche le richieste Trova luogo, Ricerca nelle vicinanze e Ricerca testuale restituiscono una singola foto riferimento per luogo, se pertinente. Tramite il servizio Foto puoi quindi accedere le foto a cui viene fatto riferimento e ridimensionarla in base alle dimensioni ottimali un'applicazione.

Richieste foto luogo

Una richiesta Place Photo è un URL HTTP con il seguente formato:

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

Per avviare una richiesta di ricerca sono necessari alcuni parametri. Come standard Negli URL, tutti i parametri sono separati dal carattere "e commerciale" (&). La i parametri con i rispettivi 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.

  • 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 al servizio Place Photo devono includere un photo_reference, restituito nella risposta a Find Place, Nearby Search, Text Search o Place Details richiesta. La risposta a queste richieste conterrà un campo photos[] se luogo presenta 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 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 per eseguire una richiesta di foto.
  • height: l'altezza massima dell'immagine.
  • width: la larghezza massima dell'immagine.
  • html_attributions[]: contiene le attribuzioni obbligatorie. Questo sarà sempre presente, ma potrebbe essere vuoto.

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

Nell'esempio seguente viene mostrata una richiesta Place Details:

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 è riportata una richiesta di esempio. Questa richiesta restituirà i dati ridimensionandola in modo che abbia una larghezza di massimo 400 pixel.

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

Risposta per foto del luogo

La risposta a una richiesta di Place Photo approvata sarà un'immagine. Il tipo di l'immagine dipenderà dal tipo di foto inviata inizialmente.

Se la richiesta supera la quota disponibile, il server restituirà un HTTP 403 e visualizza l'immagine seguente per indicare che la quota è superato:

Immagine per superamento quota

Se il server non è in grado di comprendere la richiesta, viene restituito HTTP 400 che indica una richiesta non valida. I motivi più comuni per cui le richieste non valide includono:

  • Il riferimento della foto inviato non è stato specificato correttamente.
  • La richiesta non includeva né maxwidth né maxheight parametri.
  • È stato impostato il valore del parametro maxwidth o maxheight a null.
  • L'offerta photo_reference è scaduta. Se photo_reference scade, effettua una a Place Details (Dettagli luogo) Trova luogo, Ricerca nelle vicinanze, o Ricerca testuale per ottenere il valore photo_reference aggiornato.