Introduzione
Le richieste di metadati dell'API Street View Static forniscono dati su Street View Visualizza panoramiche. Utilizzando i metadati, puoi scoprire se un'immagine di Street View è disponibile in una determinata località, oltre a ottenere l'accesso programmatico le coordinate di latitudine e longitudine, l'ID panorama, la data in cui è stata scattata la foto scattata e le informazioni sul copyright dell'immagine. Accesso a questo i metadati consentono di personalizzare il comportamento degli errori nell'applicazione.
Le richieste di metadati dell'API Street View Static sono disponibili ricarica. Non viene consumata quota quando richiedi i metadati. La quota viene consumata solo quando carichi un'immagine utilizzando la proprietà API Street View Static.
Quando effettui richieste di metadati di immagini di Street View, le immagini panoramiche è di 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
Come standard negli URL, tutti i parametri vengono separati dalla e commerciale (&).
Parametri obbligatori per le richieste di metadati
Le richieste di metadati accettano stessi parametri URL come richieste di immagini dell'API Street View Static, anche se solo i seguenti parametri sono obbligatori:
Procedi in uno dei seguenti modi:
location
: può essere una stringa di testo (ad esempioChagrin 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 possono cambiare ID nel tempo, quindi non mantenere questo ID. Salva invece l'indirizzo della posizione o coordinate di latitudine e longitudine per poter aggiornare l'ID del panorama. Per consulta Aggiornare gli ID dei panorami eliminati.
Inoltre:
key
esignature
: la chiave API è necessaria per autenticare richiesta. In alcuni casi è necessaria anche la firma digitale. sono sempre consigliati. Per ulteriori informazioni, vedi Ottieni 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=<YOUR_SIGNATURE>
o in questo modo:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
Aggiorna gli ID panoramiche eliminati
Se tenti di recuperare l'ID di un panorama e ottieni ZERO_RESULTS
o
nessun valore, significa che l'ID panoramica è stato eliminato e deve essere aggiornato.
Salva l'indirizzo della posizione o le coordinate di latitudine e longitudine utilizzati in precedenza ottenere un ID panoramica per poter aggiornare quando necessario.
Quando rilevi che l'ID di una panoramica è cambiato, utilizza la posizione originale. indirizzo o coordinate di latitudine e longitudine per cercare di nuovo panoramiche in quella posizione e ottenere un nuovo ID panoramica.
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 la panoramica trovata.
L'API consente di includere gli stessi parametri del parametro
richiesta di immagini
per semplificare la creazione di una richiesta di metadati relativa a un'immagine specifica
richiesta, ma per le richieste di metadati, l'API ignora i parametri facoltativi e
sui loro valori. Per informazioni sull'uso di questi parametri, consulta
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 dello stesso 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, 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 impossibile trovare nella località 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
Codici di stato
Il campo status
all'interno dell'oggetto di risposta dei metadati contiene lo stato di
della richiesta e potrebbe contenere informazioni di debug per aiutarti a
perché la richiesta relativa a Street View non funziona. Il campo status
può contenere
i seguenti valori:
Stato | Descrizione |
---|---|
"OK" |
Indica che non si sono verificati errori. trovato un panorama e i metadati sono restituito. |
"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 la stringa dell'indirizzo fornita nel campo location
Impossibile trovare il parametro. Questo messaggio può apparire se un indirizzo inesistente
viene fornito. |
"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 può essere visualizzato se non autorizza la tua richiesta o se L'API Street View Static non è attivata in Progetto Google Cloud Console contenente la chiave API. |
"INVALID_REQUEST" |
In genere indica che i parametri di query (indirizzo, coordinate di latitudine e longitudine o componenti) mancano. |
"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, oppure altri prodotti con l'API di Google Maps, dai un'occhiata ai prodotti Pagina di assistenza.