Recuperare i metadati di un video

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 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?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

L'API restituisce quindi una delle seguenti due risposte:

• 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 con vista aerea della Transamerica Pyramid, situata al 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 risposte possibili alla richiesta lookupVideoMetadata.

Video trovato

Il video è già stato eseguito il rendering.

{
  "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. Ciò potrebbe essere dovuto al fatto che non è ancora stato eseguito il rendering o perché la posizione si trova in un'area non supportata.

Se la posizione 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"
  }
}