Generare un nuovo video

Il renderVideo metodo richiede la generazione di un video con vista aerea per l'indirizzo postale statunitense specificato. Se il video esiste già per l'indirizzo specificato, questo metodo restituisce i metadati del video.

Come utilizzare l'API

Genera un nuovo video aereo effettuando una richiesta POST HTTPS all' renderVideo endpoint, passando la chiave API e un indirizzo postale statunitense, come mostrato nell'esempio seguente. Il processo di rendering può richiedere da un'ora a qualche ora.

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

Esempio di richiesta

Il seguente esempio di codice richiede la generazione di un video con vista aerea per 500 W 2nd St, Austin, TX, 78701.

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

Esempio di risposta

I seguenti esempi di codice JSON mostrano le possibili risposte alla richiesta di video di esempio.

Risposta con indirizzo non valido

L'indirizzo non è corretto o non si trova negli Stati Uniti.

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

Risposta di elaborazione

L'API Aerial View sta eseguendo il rendering del video. La risposta contiene il videoId, che puoi utilizzare per recuperare il video.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

Il processo di rendering può richiedere da un'ora a qualche ora. Se il video è ancora in fase di elaborazione, puoi utilizzare lookupVideo per eseguire il polling dello stato del video finché non restituisce lo stato ACTIVE.

Per eseguire il polling, invia una richiesta a lookupVideo, passando videoId. Il rendering può richiedere diverse ore, quindi utilizza un backoff esponenziale per distanziare le chiamate.

Risposta attiva

Quando renderVideo restituisce un valore state di ACTIVE, significa che il rendering del video è terminato e puoi recuperarlo chiamando lookupVideo con il videoId.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}