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 con certeza si el video existe, debes usar lookupVideoMetadata para determinar su estado.

Flujo de trabajo para generar o recuperar videos

Sigue este 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 devolvió un error 404), llama a renderVideo para generar un video 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 devolvió un estado de ACTIVE), llama a lookupVideo para recuperar los URIs del video.

   Nota: Después de que Google genera el video de una dirección específica, este queda disponible para cualquier persona. Es decir, un video no está asociado a 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 las Condiciones Específicas 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)(Sin almacenamiento en caché) de las Condiciones del Servicio de Google Maps Platform. Por lo tanto, puedes almacenar valores de ID de video para usarlos más adelante.