Como usar a API Aerial View

A API Aerial View é compatível com dois fluxos de trabalho gerais. Sua abordagem depende de 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 visão aérea:

1. Verifique se o Google já gerou um vídeo para o local usando lookupVideoMetadata.
2. Se não houver um vídeo (lookupVideoMetadata retornou um erro 404), chame renderVideo para gerar um novo vídeo.
   1. Chame lookupVideoMetadata usando o videoId ou o endereço para pesquisar o endpoint até que o estado do vídeo seja ACTIVE. A renderização pode levar várias horas. Por isso, use a retirada exponencial para espaçar suas chamadas.

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

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

Esse fluxo de trabalho é representado no diagrama abaixo:

Salvar IDs de vídeo para uso posterior

Sujeitos aos Termos específicos do 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)(Sem armazenamento em cache) dos Termos de Serviço da Plataforma Google Maps. Portanto, você pode armazenar os valores de ID de vídeo para usar depois.