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 inviando 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 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 ora 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 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 è stato completato e puoi recuperarlo chiamando lookupVideo con il valore videoId.

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