Recupera i metadati di un video

Se un indirizzo o ID video è valido, il metodo lookupVideoMetadata restituisce i metadati associati a un determinato video. I metadati nel corpo della risposta ti permettono di determinare il grado di freschezza delle immagini e la durata del video, oltre a fornire un flusso di lavoro senza costi per verificare l'esistenza dei video.

Come utilizzare l'API

Chiama questo endpoint trasmettendo un indirizzo postale degli Stati Uniti con codifica 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 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 visualizzazione aerea per la Transamerica Pyramid, 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 mostrano tutte le possibili risposte alla richiesta lookupVideoMetadata.

Video trovato

Il video è già stato visualizzato.

{
  "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. Il motivo potrebbe essere che non è stata ancora visualizzata o che 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"
  }
}