Metadati delle immagini di Street View

Introduzione

Le richieste di metadati dell'API Street View Static forniscono dati sui panorami di Street View. Utilizzando i metadati, puoi scoprire se un'immagine di Street View è disponibile in una determinata località, nonché ottenere l'accesso programmatico alle coordinate di latitudine e longitudine, l'ID panorama, la data in cui è stata scattata la foto e le 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 data può variare.

• Il campo Data può avere una granularità diversa a seconda del panorama. Ad esempio, il campo data di alcuni panorami 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. Non viene consumata quota quando richiedi i metadati. La quota viene consumata solo quando carichi un'immagine utilizzando l'API Street View Static.

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

Accedi ai metadati delle immagini

Una richiesta di metadati di immagini di Street View è un URL HTTP con il seguente formato:

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

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

Come avviene standard negli URL, tutti i parametri vengono separati dal carattere "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 richiesti 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 separate da virgole (40.457375,-80.009353).

Oppure:

• pano: un ID panoramica specifico. I panorami potrebbero cambiare ID nel tempo, quindi non conservare questo ID. Salva invece l'indirizzo della posizione o le coordinate di latitudine e longitudine per aggiornare l'ID del panorama. Per maggiori dettagli, consulta Aggiornare gli ID delle panoramiche eliminati.

Inoltre:

• key e signature: la chiave API è necessaria per autenticare la richiesta. La firma digitale è anche obbligatoria in alcuni casi e sempre consigliata. Per ulteriori informazioni, consulta la sezione 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 panoramiche eliminati

Se provi a recuperare l'ID di una panoramica e visualizzi ZERO_RESULTS o nessun valore, significa che l'ID panoramica è stato eliminato e deve essere aggiornato.

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

2. Quando rilevi che l'ID di una panoramica è 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 di volta in volta da posizioni leggermente diverse, un determinato ID panoramica può agganciarsi a una panoramica diversa quando le immagini o l'ID panoramica vengono aggiornati.

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 influenzano i dati relativi alla panoramica o alla panoramica trovata. L'API consente l'inclusione degli stessi parametri della richiesta di immagini per semplificare la creazione di una richiesta di metadati relativa a una richiesta di immagini specifica. Tuttavia, per le richieste di metadati, l'API ignora i parametri facoltativi e i relativi valori. Per informazioni sull'utilizzo di 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 panorama.

Richiesta e risposta dei 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

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 è possibile trovare nella posizione specificata o nelle sue vicinanze.

Richiesta e risposta relativa ai 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 alle 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 nell'oggetto di risposta dei metadati contiene lo stato della richiesta e potrebbe contenere informazioni di debug per aiutarti a risolvere il motivo 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 [Aggiornare gli ID delle panoramiche eliminati](#refresh-pano).
"NOT_FOUND"	Indica che non è stato possibile trovare la stringa dell'indirizzo fornita nel parametro location. Questo messaggio può apparire 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 tua chiave API.
"INVALID_REQUEST"	In genere indica che mancano i parametri di query (coordinate di indirizzo, latitudine e longitudine o componenti).
"UNKNOWN_ERROR"	Indica che non è stato possibile elaborare la richiesta a causa di un errore del server. Questo problema è spesso temporaneo. Riprova.

Ulteriori informazioni

Per ulteriori informazioni sull'utilizzo dell'API Street View Static o su altri prodotti dell'API di Google Maps, consulta la pagina Assistenza dell'API di Google Maps.