Se un indirizzo o ID video è valido, il metodo lookupVideoMetadata
restituisce i metadati associati a un determinato video. I metadati nel
corpo della risposta ti permettono di determinare il grado di freschezza delle immagini e la durata
del video, oltre a fornire un flusso di lavoro senza costi per verificare l'esistenza dei video.
Come utilizzare l'API
Chiama questo endpoint trasmettendo un indirizzo postale degli Stati Uniti con codifica 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,
lookupVideoMetadata
restituisce 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, 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 mostrano tutte le possibili risposte alla richiesta lookupVideoMetadata
.
Video trovato
Il video è già stato visualizzato.
{
"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 è presente nel database di Google. Il motivo potrebbe essere che non è stata ancora visualizzata 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"
}
}