Como usar a API Aerial View

A API Aerial View é compatível com dois fluxos de trabalho gerais. Sua abordagem depende da existência ou não do vídeo solicitado. 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 da 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 retornou um erro 404), chame renderVideo para gerar um novo.
   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. 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, 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 uso posterior.