Como usar a API Aerial View

A API Aerial View oferece suporte a dois fluxos de trabalho gerais. Sua abordagem depende se o vídeo que você está solicitando existe ou não. Se você não tiver certeza se o vídeo existe, use lookupVideoMetadata para determinar o estado dele.

Fluxo de trabalho para gerar ou recuperar vídeos

Use o fluxo de trabalho a seguir para gerar ou recuperar um vídeo de vista aérea:

1. Verifique se o Google já gerou um vídeo para o local usando lookupVideoMetadata.
2. Se nenhum vídeo existir (lookupVideoMetadata retornar um 404), chame renderVideo para gerar um novo vídeo.
   1. Chame lookupVideoMetadata usando o videoId ou o endereço para consultar o endpoint até que o estado do vídeo seja ACTIVE. A renderização pode levar várias horas. Portanto, use a espera exponencial para distribuir as chamadas.

3. Se o vídeo estiver ativo (lookupVideoMetadata retornar um estado de ACTIVE), chame lookupVideo para buscar os URIs do vídeo.

   Observação: depois que o Google gera o vídeo para um endereço específico, ele fica disponível para qualquer pessoa. Ou seja, um vídeo não é associado a um usuário ou conta específico.

Esse fluxo de trabalho é representado no diagrama abaixo:

Salvar IDs de vídeos para uso posterior

Sujeito aos Termos Específicos de Serviço da API Aerial View, os IDs de vídeo da API Aerial View estão isentos das restrições de armazenamento em cache definidas na Seção 3.2.3(b)(No Caching) dos Termos de Serviço da Plataforma Google Maps. Portanto, você pode armazenar os valores de ID de vídeo para uso posterior.