Metadati delle immagini di Street View

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à, nonché l'accesso programmatico a 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 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 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 e signature: 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=

o in questo modo:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&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.

  1. Salva l'indirizzo della posizione o le coordinate di latitudine e longitudine utilizzati in precedenza ottenere un ID panoramica per poter aggiornare quando necessario.

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

di Gemini Advanced.

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

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
Segnaposto per nessuna immagine qui

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.