Metadati immagine di Street View

Introduzione

Le richieste ai 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 per una determinata località, oltre ad avere accesso programmatico alla latitudine e alla longitudine, all'ID del panorama, alla data in cui è stata scattata la foto e alle informazioni sul copyright relative all'immagine. L'accesso a questi metadati ti consente di personalizzare il comportamento di errore nella tua applicazione.

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

Quando invii richieste di metadati per le immagini di Street View, le immagini panoramiche sono accurate fino a 50 metri.

Accesso ai metadati delle immagini

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

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

Come avviene negli URL, tutti i parametri sono separati utilizzando la 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, 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/longitudine (40.457375,-80.009353) separate da virgole.

Oppure:

• pano: un ID panorama specifico. In genere sono stabili, ma i panorami possono cambiare l'ID nel tempo man mano che le immagini vengono aggiornate.

Inoltre:

• key e signature: la chiave API è obbligatoria per autenticare la richiesta. In alcuni casi, la firma digitale è obbligatoria e sempre consigliata. Per maggiori informazioni, consulta la pagina Ottieni una chiave e una firma.

La richiesta di metadati, con solo i parametri obbligatori, avrà il seguente aspetto:

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

o 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 che si trova. L'API consente di includere gli 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. Consulta la guida per gli sviluppatori di API Street View Static per informazioni sull'utilizzo di questi parametri.

Formato della risposta

Le risposte dei metadati vengono restituite solo in formato JSON.

Esempi

Esempio 1: panoramica eseguita

I seguenti URL richiedono correttamente i metadati e l'immagine dello stesso panorama.

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 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

Esempio 2: panoramica non trovata

I seguenti URL richiedono i metadati e l'immagine per una panoramica che non è stato possibile trovare vicino alla 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

Codici di stato

Il campo status all'interno dell'oggetto di risposta dei metadati contiene lo stato della richiesta e potrebbe contenere informazioni di debug per aiutarti a risolvere i problemi perché 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; viene trovata una panoramica e vengono restituiti i metadati.
"ZERO_RESULTS"	Indica che non è stato possibile trovare panorama vicino alla posizione fornita. Questo può accadere se viene fornito un ID panoramica inesistente o non valido.
"NOT_FOUND"	Indica che non è stato possibile trovare la stringa indirizzo fornita nel parametro location. Questo può accadere 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. Ciò può verificarsi se non hai autorizzato la richiesta o se l'API Street View Static non è attivata nel progetto Google Cloud Console contenente la chiave API.
"INVALID_REQUEST"	In genere indica che mancano i parametri di ricerca (indirizzo, latlng o componenti).
"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 riprovi, la richiesta potrebbe avere esito positivo.

Ulteriori informazioni

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