Il metodo renderVideo richiede la generazione di un video in visualizzazione aerea per l'indirizzo postale statunitense specificato. 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, trasmettendo la chiave API e un indirizzo postale statunitense, come mostrato
nell'esempio seguente. Il processo di rendering può richiedere
da un'ora ad alcune 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 una 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 video di esempio.
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 il polling dello stato del video fino a quando non restituisce lo stato 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 rendering del video è terminato e puoi recuperarlo chiamando lookupVideo con videoId.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}