Generare un nuovo video

Il metodo renderVideo richiede la generazione di un video con visualizzazione 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'endpoint renderVideo, passando la tua 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 esempio di video.

Risposta all'indirizzo non valida

L'indirizzo è errato 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 l'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 il backoff esponenziale per distanziare le chiamate.

Risposta attiva

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

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