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 solicitado existe ou não. Caso você não tenha 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. Confira 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 a 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 espera exponencial para espaçar as 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 para um endereço específico, ele fica disponível para qualquer pessoa. Ou seja, o vídeo não está associado a um usuário ou conta específicos.

Esse fluxo de trabalho é representado no diagrama abaixo:

Salvar IDs dos vídeos para uso posterior

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