Cómo usar la API de Aerial View

La API de Aerial View admite dos flujos de trabajo generales. Tu enfoque dependerá de si el video que solicitas existe o no. Si no sabes si el video existe, debes usar lookupVideoMetadata para determinar su estado.

Flujo de trabajo para generar o recuperar videos

Usa el siguiente flujo de trabajo para generar o recuperar un video de vista aérea:

1. Verifica si Google ya generó un video para la ubicación con lookupVideoMetadata.
2. Si no existe ningún video (lookupVideoMetadata muestra un error 404), llama a renderVideo para generar uno nuevo.
   1. Llama a lookupVideoMetadata con videoId o la dirección para sondear el extremo hasta que el estado del video sea ACTIVE. La renderización puede tardar varias horas, por lo que debes usar la retirada exponencial para espaciar tus llamadas.

3. Si el video está activo (lookupVideoMetadata muestra un estado de ACTIVE), llama a lookupVideo para recuperar los URIs del video.

   Nota: Después de que Google genera el video para una dirección específica, este está disponible para cualquier persona. Es decir, un video no está asociado con un usuario o una cuenta específicos.

Este flujo de trabajo se representa en el siguiente diagrama:

Guarda los IDs de video para usarlos más adelante

Sujeto a los Términos Específicos del Servicio de la API de Aerial View, los IDs de video de la API de Aerial View están exentos de las restricciones de almacenamiento en caché establecidas en el Artículo 3.2.3(b)(No Caching) de las Condiciones del Servicio de Google Maps Platform. Por lo tanto, puedes almacenar valores de ID de video para usarlos más adelante.