Cómo usar la API de Aerial View

La API de Aerial View admite dos flujos de trabajo generales. Tu enfoque depende 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 mostró un error 404), llama a renderVideo para generar un video nuevo.
   1. Llama a lookupVideoMetadata con el videoId o la dirección para sondear el extremo hasta que el estado del video sea ACTIVE. El procesamiento puede tardar varias horas, por lo que debes usar la retirada exponencial para espaciar las llamadas.

3. Si el video está activo (lookupVideoMetadata mostró el estado ACTIVE), llama a lookupVideo para recuperar los URI del video.

   Nota: Una vez que Google genera el video para una dirección específica, está disponible para todos los usuarios. 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:

Cómo guardar los IDs de los videos para usarlos en otro momento

Sujeto a las Condiciones Específicas del Servicio para la API de Aerial View, los IDs de video de la API 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 en otro momento.