Recupera i metadati di un video

Dato un indirizzo o un videoID 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, la durata del video e forniscono anche un flusso di lavoro gratuito per confermare l'esistenza dei video.

Come utilizzare l'API

Chiama questo endpoint passando un indirizzo postale degli Stati Uniti 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 seguenti risposte:

• Se il video esiste, lookupVideoMetadata restituisce i relativi metadati.
• Se il video non esiste, l'API restituisce un codice di errore 404.

Richiesta di esempio

Il seguente esempio di codice richiede un video con vista aerea della piramide Transamerica, situata in 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

Gli esempi JSON seguenti mostrano 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 è presente nel database di Google. Questo potrebbe essere dovuto al fatto che non è stato ancora visualizzato o perché la stazione di ricarica 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"
  }
}