Metadati delle immagini di Street View

Introduzione

Le richieste di metadati dell'API Street View Static forniscono dati sulle panoramiche 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, all'ID panoramica, alla data in cui è stata scattata la foto e alle informazioni sul copyright dell'immagine. L'accesso a questi metadati ti consente di personalizzare il comportamento in caso di errori nella tua applicazione.

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

• Il campo della data può avere una granularità diversa per le diverse panoramiche. Ad esempio, il campo della data per alcune panoramiche contiene un anno e un mese, mentre per altre 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. Non viene consumata alcuna 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 delle immagini di Street View, le immagini panoramiche sono accurate fino a 50 metri.

Accedere ai metadati delle immagini

Una richiesta di metadati delle immagini di Street View è un URL HTTP nel seguente formato:

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

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

Come di consueto negli URL, tutti i parametri sono separati utilizzando il 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 obbligatori solo i seguenti parametri:

Procedi in uno dei seguenti modi:

• location : può essere una stringa di testo (ad es. 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. Gli ID delle panoramiche potrebbero cambiare nel tempo, quindi non conservarli. Salva invece l'indirizzo della località o le coordinate di latitudine e longitudine in modo da poter aggiornare l'ID panoramica. Per maggiori dettagli, vedi Aggiornare gli ID panoramica eliminati.

Oltre a:

• key e signature : la chiave API è obbligatoria per autenticare la richiesta. In alcuni casi è richiesta anche la firma digitale, che è sempre consigliata. Per maggiori informazioni, vedi Ottenere una chiave e una firma.

La 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=<YOUR_SIGNATURE>

Oppure:

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

Aggiornare gli ID panoramica eliminati

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

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

2. Quando rilevi che un ID panoramica è cambiato, utilizza l'indirizzo della località 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 foto potrebbero essere scattate da posizioni leggermente diverse ogni volta, un determinato ID panoramica potrebbe allinearsi a una panoramica diversa quando le immagini o l'ID panoramica vengono aggiornati.

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 sulla panoramica o la panoramica trovata. L'API consente l'inclusione degli stessi parametri della richiesta di immagini per semplificare la creazione di una richiesta di metadati correlata a una richiesta di immagini specifica, ma 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 ai 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 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, dove l'immagine mancante è prevista.

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

Esempio 2: panoramica non trovata

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

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

Codici di stato

Il campo status all'interno dell'oggetto di risposta dei metadati contiene lo stato della richiesta e può contenere informazioni di debug per aiutarti a risolvere il problema 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; è stata trovata una panoramica e vengono restituiti i metadati.
"ZERO_RESULTS"	Indica che non è stato possibile trovare alcuna panoramica vicino alla località fornita. Questa risposta può verificarsi se fornisci un ID panoramica inesistente o non valido. Vedi [Aggiornare gli ID panoramica eliminati](#refresh-pano).
"NOT_FOUND"	Indica che non è stato possibile trovare la stringa dell'indirizzo fornita nel parametro location. Questo messaggio può essere visualizzato 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 messaggio può 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"	In genere indica che mancano i parametri di query (indirizzo, coordinate di 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. La richiesta potrebbe andare a buon fine se riprovi.

Ulteriori informazioni

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