Metadati delle immagini di Street View

Introduzione

Le richieste di metadati dell'API Street View Static forniscono dati sulle panoramiche di Street View. Utilizzando i metadati, puoi scoprire se un'immagine di Street View è disponibile in un determinato luogo, nonché ottenere accesso programmatico alle coordinate di latitudine e longitudine, all'ID panoramica, alla data in cui è stata scattata la foto e alle informazioni sul copyright dell'immagine. L'accesso a questi metadati consente di personalizzare il comportamento degli errori nella tua applicazione.

Nota : il valore del campo della data può variare:

• Il campo della data può avere un livello di granularità diverso a seconda delle panoramiche. Ad esempio, il campo della data di alcune panoramiche contiene l'anno e il mese, mentre per altri contiene solo l'anno.
• Il campo della data viene omesso se non sono disponibili dati.

Le richieste di metadati dell'API Street View Static sono disponibili senza costi aggiuntivi. Quando richiedi i metadati, non viene consumata nessuna quota. La quota viene consumata solo quando carichi un'immagine utilizzando l'API Street View Static.

Quando si effettuano richieste di metadati per immagini Street View, le immagini panoramiche sono precise fino a 50 metri.

Accedere ai metadati delle immagini

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

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

Nota: il protocollo https:// è obbligatorio per le richieste di metadati.

Come standard negli URL, tutti i parametri sono separati dalla e commerciale (&).

Parametri obbligatori per le richieste di metadati

Le richieste di metadati accettano gli stessi parametri URL delle richieste di immagini dell'API Street View Static, anche se sono obbligatori 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 e longitudine (40.457375,-80.009353) separate da virgole.

Oppure:

• pano: un ID panorama specifico. L'ID dei panorami può cambiare nel tempo, quindi non conservare questo ID. Salva invece l'indirizzo della località o le coordinate di latitudine e longitudine in modo da poter aggiornare l'ID panoramica. Per maggiori dettagli, consulta la sezione Aggiornare gli ID panoramiche eliminati.

Inoltre:

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

La tua richiesta di metadati, con solo i parametri obbligatori, ha il seguente aspetto:

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

o in questo modo:

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

Aggiorna gli ID panoramica eliminati

Se tenti di recuperare un ID panoramica e ottenere il valore ZERO_RESULTS o nessun valore, l'ID panoramica è stato eliminato e deve essere aggiornato.

1. Salva l'indirizzo della posizione o le coordinate di latitudine e longitudine utilizzate per ottenere l'ID panoramica, in modo da poter aggiornare quando necessario.

2. Quando rilevi che l'ID di un panorama è cambiato, utilizza l'indirizzo della posizione originale o le coordinate di latitudine e longitudine per cercare di nuovo le panoramiche più vicine a quella località e ottenere un nuovo ID panoramica.

Nota: poiché le immagini di Street View vengono aggiornate periodicamente e le fotografie possono essere scattate da posizioni leggermente diverse ogni volta, un determinato ID panoramica potrebbe agganciarsi a una panoramica diversa in seguito all'aggiornamento delle immagini o dell'ID panoramica.

Parametri facoltativi per le richieste di metadati

Puoi includere i seguenti parametri nella richiesta di metadati: size, heading, fov e pitch. Tieni presente che questi parametri non influenzano i dati relativi alla panoramica o alla panoramica trovata. L'API consente di includere gli stessi parametri della richiesta di immagini per semplificare la creazione di una richiesta di metadati relativa a una specifica richiesta di immagini; tuttavia, per le richieste di metadati, l'API ignora i parametri facoltativi e i relativi valori. Per informazioni su come utilizzare questi parametri, consulta la Guida per gli sviluppatori dell'API Street View Static.

Formato della risposta

Le risposte dei metadati vengono restituite solo in formato JSON.

Esempi

Esempio 1: panoramica trovata

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 di immagini, dove è 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

I campioni potrebbero non essere disponibili nella tua regione.

Esempio 2: Panoramica non trovata

I seguenti URL richiedono i metadati e l'immagine di una panoramica che non è stato possibile trovare nella posizione specificata o nelle vicinanze.

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

I campioni potrebbero non essere disponibili nella tua regione.

Codici di stato

Il campo status all'interno dell'oggetto risposta dei metadati contiene lo stato della richiesta e potrebbe contenere informazioni di debug utili per risolvere i motivi per cui la richiesta di Street View non funziona. Il campo status può contenere i seguenti valori:

Stato	Descrizione
"OK"	Indica che non si sono verificati errori; è stato trovato un panorama e vengono restituiti i metadati.
"ZERO_RESULTS"	Indica che non è stato trovato alcun panorama vicino alla posizione specificata. Questa risposta può verificarsi se fornisci un ID panoramica inesistente o non valido. Consulta la sezione [Aggiorna gli ID panoramiche eliminati](#refresh-pano).
"NOT_FOUND"	Indica che non è stato possibile trovare la stringa dell'indirizzo fornita nel parametro location. Questo messaggio potrebbe essere visualizzato se viene fornito un indirizzo inesistente.
"OVER_QUERY_LIMIT"	Indica che hai superato la quota giornaliera o al secondo per questa API.
"REQUEST_DENIED"	Indica che la richiesta è stata rifiutata. Questo messaggio potrebbe essere visualizzato se non hai autorizzato la richiesta o se l'API Street View Static non è attivata nel progetto della console Google Cloud contenente la chiave API.
"INVALID_REQUEST"	Indica in genere che i parametri di query (indirizzo, coordinate di latitudine e longitudine o componenti) sono mancanti.
"UNKNOWN_ERROR"	Indica che non è stato possibile elaborare la richiesta a causa di un errore del server. Questo problema è spesso temporaneo. Se riprovi, la richiesta potrebbe riuscire.

Maggiori informazioni

Per ulteriori informazioni sull'utilizzo dell'API Street View Static o di altri prodotti basati sull'API di Google Maps, consulta la pagina relativa all'assistenza per l'API di Google Maps.