Genera un nuovo video

La renderVideo richiede la generazione di un video in visualizzazione aerea per gli Stati Uniti specificati l'indirizzo postale. Se il video esiste già per l'indirizzo specificato, allora restituisce i metadati relativi al video.

Come utilizzare l'API

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

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 della 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 al video di esempio richiesta.

Risposta indirizzo non valida

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

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

Elaborazione della risposta in corso...

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

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

Il processo di rendering può richiedere da un'ora ad alcune ore. Se Il video è ancora in fase di elaborazione, puoi utilizzare lookupVideo per eseguire un sondaggio sullo stato del video finché non restituisce lo stato ACTIVE.

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

Risposta attiva

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

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