Se hai un indirizzo o un ID video valido,
lookupVideoMetadata
restituisce i metadati associati a un determinato video. I metadati in
corpo della risposta consente di determinare l'attualità delle immagini, la lunghezza
oltre a un flusso di lavoro senza costi per confermare l'esistenza dei video.
Come utilizzare l'API
Chiama questo endpoint passandogli un codice postale statunitense codificato in URL
un indirizzo email 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 una vista aerea per la Transamerica Piramide, 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 alle
Richiesta di 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 sono ancora state o perché la località si trova in un'area non supportata.
Se la località si trova in un
area, puoi utilizzare
renderVideo
per avviare una richiesta di rendering.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}