Genera un video nuevo

El renderVideo método solicita la generación de un video de vista aérea para el EE.UU. especificado dirección postal. Si el video ya existe para la dirección especificada, este método devuelve metadatos sobre el video.

Cómo usar la API

Genera un nuevo video aéreo realizando una solicitud HTTPS POST al renderVideo extremo, pasando 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 a 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

El siguiente ejemplo de código 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 al video de ejemplo para cada solicitud.

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 videoId, que puedes usar para recuperar el video.

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

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

Para sondear, realiza una solicitud a lookupVideo y pasa el videoId. La renderización puede puede tardar varias horas, así que usa el formato exponencial retirada para espaciar las llamadas.

Respuesta activa

Cuando renderVideo devuelve un valor state de ACTIVE, significa que el video tiene finaliza la renderización, y puedes recuperarla llamando a lookupVideo con el videoId

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