Dato un indirizzo o un ID video valido, il metodo lookupVideoMetadata restituisce i metadati associati a un determinato video. I metadati nel corpo della risposta ti consentono di determinare l'aggiornamento delle immagini e la durata del video e forniscono anche un flusso di lavoro senza costi per confermare l'esistenza dei video.
Come utilizzare l'API
Chiama questo endpoint trasmettendogli un indirizzo postale statunitense codificato in URL o un videoId.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
L'API restituisce quindi una delle due risposte seguenti:
- Se il video esiste,
lookupVideoMetadatarestituisce i metadati del video. - Se il video non esiste, l'API restituisce un codice di errore 404.
Esempio di richiesta
Il seguente esempio di codice richiede un video di visualizzazione aerea per la Transamerica Pyramid, situata all'indirizzo 600 Montgomery St, San Francisco, CA 94111.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"
Esempio di risposta
I seguenti esempi JSON dimostrano tutte le possibili risposte alla richiesta lookupVideoMetadata.
Video trovato
Il rendering del video è già stato eseguito.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"captureDate": {
"year": 2022,
"month": 4,
"day": 1
},
"duration": "40s",
"state": "ACTIVE"
}
Rendering del video in corso...
Rendering del video in corso...
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"state": "PROCESSING"
}
Video non trovato
Il video non è nel database di Google. Il motivo potrebbe essere che non è stato ancora visualizzato o che la località si trova in un'area non supportata.
Se la località si trova in un'area
supportata, puoi utilizzare
renderVideo
per avviare una richiesta di rendering.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}