Genera un nuovo video

Il metodo renderVideo richiede la generazione di un video con vista aerea per l'indirizzo postale stato unito 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, trasmettendo la chiave API e un indirizzo postale statunitense, come mostrato nell'esempio seguente. Il processo di rendering può richiedere da un'ora a diverse ore.

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

Richiesta di esempio

Il seguente esempio di codice richiede la generazione di un video con vista aerea per la sede al 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 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 il valore videoId, che puoi utilizzare per recuperare il video.

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

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

Per fare un sondaggio, invia una richiesta a lookupVideo, trasmettendo il videoId. Il rendering può richiedere diverse ore, quindi utilizza il backoff esponenziale per distribuire le chiamate.

Risposta attiva

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

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