Il metodo renderVideo richiede la generazione di un video di visualizzazione aerea per l'indirizzo postale specificato negli Stati Uniti. Se il video esiste già per l'indirizzo specificato, questo metodo restituisce i metadati relativi al 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 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 di visualizzazione 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 video di esempio.
Risposta indirizzo non valida
L'indirizzo non è corretto o 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 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 sondaggio, invia una richiesta a lookupVideo, trasmettendo l'videoId. Il rendering può richiedere diverse ore, quindi utilizza il backoff esponenziale per separare le chiamate.
Risposta attiva
Se renderVideo restituisce un valore state pari a ACTIVE, significa che il rendering del video è stato completato e puoi recuperarlo chiamando lookupVideo con videoId.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}