Genera un video nuevo

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 para la dirección especificada, este método muestra metadatos sobre el video.

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 de renderización puede tardar desde una hora hasta algunas 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 muestran las posibles respuestas a la solicitud de video de ejemplo.

Respuesta de dirección no válida

La dirección es incorrecta o no está dentro de Estados Unidos.

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

Procesando respuesta

La API de Aerial View ahora renderiza tu video. La respuesta contiene el elemento videoId, que puedes usar para recuperar el video.

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

El proceso de renderización puede tardar entre una y varias horas. Si el video aún se está procesando, puedes usar lookupVideo para sondear su estado hasta que muestre un estado de ACTIVE.

Para sondear, realiza una solicitud a lookupVideo y pasa el videoId. La renderización puede tardar varias horas, por lo que debes usar la retirada exponencial para espaciar las llamadas.

Respuesta activa

Cuando renderVideo muestra un valor state de ACTIVE, significa que el video finalizó su renderización y puedes recuperarlo llamando a lookupVideo con videoId.

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