Metadati immagine di Street View

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Introduzione

Le richieste di metadati dell'API Street View statico forniscono dati sulle panoramiche di Street View. Utilizzando i metadati, puoi scoprire se un'immagine di Street View è disponibile in una determinata posizione, nonché accedere in modo programmatico a latitudine e longitudine, all'ID del panorama, alla data in cui è stata scattata la foto e alle informazioni sul copyright per l'immagine. L'accesso a questi metadati ti consente di personalizzare il comportamento degli errori nella tua applicazione.

Le richieste di metadati dell'API Street View statico sono disponibili senza costi aggiuntivi. Non viene utilizzata alcuna quota quando richiedi i metadati. La quota viene utilizzata solo quando carichi un'immagine utilizzando l'API Street View Static.

Quando si effettuano richieste di metadati delle immagini di Street View, le immagini panoramiche hanno una precisione di 50 metri.

Accesso ai metadati delle immagini

Una richiesta di metadati di un'immagine di Street View è un URL HTTP nel seguente formato:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

Come accade negli URL, tutti i parametri sono separati utilizzando la e commerciale (&).

Parametri obbligatori per richieste di metadati

Le richieste di metadati accettano gli stessi parametri URL delle richieste di immagini API di Street View, anche se sono necessari solo i seguenti parametri:

Procedi in uno dei seguenti modi:

  • location: può essere una stringa di testo (ad esempio Chagrin Falls, OH) o una coppia di coordinate di latitudine/longitudine (40.457375,-80.009353) separate da virgole.

Oppure:

  • pano: un ID panoramico specifico. In genere sono stabili, anche se i panorami potrebbero cambiare l'ID nel tempo man mano che le immagini vengono aggiornate.

Oltre a:

  • key e signature: la chiave API è necessaria per autenticare la richiesta. La firma digitale è richiesta anche in alcuni casi e sempre consigliata. Per ulteriori informazioni, consulta la pagina Scarica una chiave e una firma.

La richiesta di metadati, con i soli parametri obbligatori, sarà simile a questa:

https://maps.googleapis.com/maps/api/streetview/metadata?location=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

oppure in questo modo:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

Parametri facoltativi per le richieste di metadati

Nella richiesta di metadati puoi includere i seguenti parametri: size, heading, fov e pitch. Tieni presente che questi parametri non influiscono sui dati relativi al panorama o sul panorama rilevato. L'API consente di includere gli stessi parametri della richiesta di immagini per semplificare la creazione di una richiesta di metadati relativa a una richiesta di immagini specifica, ma per le richieste di metadati l'API ignora i parametri facoltativi e i loro valori. Per informazioni sull'utilizzo di questi parametri, consulta laguida dello sviluppatore dell'API Street View Static.

Formato della risposta

Le risposte dei metadati vengono restituite solo in formato JSON.

Esempi

Esempio 1: panoramica mostrata

I seguenti URL richiedono correttamente i metadati e l'immagine della stessa panoramica.

Richiesta e risposta di metadati

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

Richiesta e risposta delle immagini in cui è prevista l'immagine mancante.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Torre Eiffel

Esempio 2: panorama non trovato

I seguenti URL richiedono i metadati e l'immagine di una panoramica che non è stato possibile trovare o in prossimità della posizione specificata.

Richiesta e risposta di metadati

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{
   "status" : "ZERO_RESULTS"
}

Richiesta e risposta di immagini

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Segnaposto per Nessuna immagine qui

Codici di stato

Il campo status all'interno dell'oggetto risposta metadati contiene lo stato della richiesta e potrebbe contenere informazioni di debug per aiutarti a risolvere il problema perché la richiesta Street View non funziona. Il campo status può contenere i seguenti valori:

Stato Descrizione
"OK" Indica che non si sono verificati errori; viene trovato un panorama e vengono restituiti i metadati.
"ZERO_RESULTS" Indica che non è stato trovato alcun panorama vicino alla posizione specificata. Questo può accadere se viene fornito un ID panorama inesistente o non valido.
"NOT_FOUND" Indica che la stringa dell'indirizzo fornita nel parametro location non è stata trovata. Questo può verificarsi se viene fornito un indirizzo inesistente.
"OVER_QUERY_LIMIT" Indica che hai superato la quota giornaliera o la quota al secondo per questa API.
"REQUEST_DENIED" Indica che la tua richiesta è stata rifiutata. Questo può verificarsi se non hai autorizzato la richiesta o se l'API Street View Static non è attivata nel progetto Google Cloud Console contenente la tua chiave API.
"INVALID_REQUEST" Indica in genere che i parametri di ricerca (indirizzo o latlng o componenti) sono mancanti.
"UNKNOWN_ERROR" Indica che non è stato possibile elaborare la richiesta a causa di un errore del server. Spesso si tratta di uno stato temporaneo. Se provi nuovamente, la richiesta potrebbe avere esito positivo.

Ulteriori informazioni

Per scoprire di più sull'utilizzo dell'API Street View Static o di altri prodotti API di Google Maps, consulta la pagina di assistenza dell'API di Google Maps.