El método renderVideo solicita la generación de un video de vista aérea para la dirección postal de EE.UU. especificada. Si el video ya existe en la dirección especificada, este método muestra metadatos sobre él.
Cómo usar la API
Para generar un video aéreo nuevo, realiza una solicitud HTTPS POST al extremo renderVideo y pasa tu clave de API y una dirección postal de EE.UU., como se muestra en el siguiente ejemplo. El proceso puede tardar entre una hora y unas horas.
curl -X POST -d '{
"address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Ejemplo de solicitud
En el siguiente ejemplo de código, se solicita la generación de un video de vista aérea para 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"
Ejemplo de respuesta
En las siguientes muestras de código JSON, se indican las posibles respuestas a la solicitud de video de ejemplo.
Respuesta de dirección no válida
La dirección es incorrecta o no se encuentra dentro de Estados Unidos.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Procesando respuesta
La API de Aerial View está procesando tu video. La respuesta contiene el videoId, que puedes usar para recuperar el video.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
El procesamiento puede tardar desde una hora hasta unas horas. Si el video aún se está procesando, puedes usar lookupVideo para sondear el estado del video hasta que muestre un estado ACTIVE.
Para sondear, haz una solicitud a lookupVideo y pasa el videoId. El procesamiento puede tardar varias horas, así que usa la retirada exponencial para espaciar las llamadas.
Respuesta activa
Cuando renderVideo muestra un valor state de ACTIVE, significa que se terminó de renderizar el video. Para recuperarlo, llama a lookupVideo con el videoId.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}