Recupera i metadati di un video

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 trasmettendolo 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 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

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 supportata, puoi utilizzare renderVideo per avviare una richiesta di rendering.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}