Cómo usar la API de Aerial View

La API de vista aérea admite dos flujos de trabajo generales. Tu enfoque depende de si el video que solicitaste 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. Usa lookupVideoMetadata para verificar si Google ya generó un video para la ubicación.
2. Si no existe un video (lookupVideoMetadata mostró un error 404), llama a renderVideo para generar uno 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 tus llamadas.

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

   Nota: Una vez que Google genera el video para una dirección específica, ese video 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:

Cómo guardar los ID de video para usarlos en otro momento

Sujetos a las Condiciones Específicas del Servicio para 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 en otro momento.