Dato un indirizzo o un videoID valido, il
lookupVideoMetadata
metodo restituisce i metadati associati a un determinato video. I metadati nel corpo della risposta ti consentono di determinare la freschezza delle immagini, 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 passandogli un indirizzo postale statunitense codificato tramite URL
o un
videoId.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?X-Goog-Api-Key=YOUR_API_KEY&address=POSTAL_ADDRESS "
L'API restituisce 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 con vista aerea della Transamerica Pyramid, situata al 600 di Montgomery St, San Francisco, CA 94111.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?X-Goog-Api-Key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"
Esempio di risposta
I seguenti esempi JSON mostrano tutte le risposte possibili 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 è presente nel database di Google. Questo potrebbe essere dovuto al fatto che il rendering non è ancora stato eseguito o perché 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"
}
}