Introdução ao 3D Area Explorer

imagem

Visão geral

A solução 3D Area Explorer oferece uma maneira totalmente nova de descobrir e conhecer locais. Essa solução usa os recursos dos blocos fotorrealistas em 3D da Plataforma Google Maps e da API Places para criar ambientes 3D cativantes e interativos.

O 3D Area Explorer foi projetado para várias finalidades:

  • Aprimorar a exploração de áreas:os usuários podem explorar os bairros virtualmente com um alto grau de detalhes visuais, conseguindo insights sobre características e pontos de referência locais.

  • Promover narrativas baseadas em localização: a capacidade de incorporar PDIs (pontos de interesse) com descrições detalhadas permite a criação de experiências narrativas que educam e informam os usuários sobre locais específicos.

  • Inspirar o desenvolvimento usando os recursos 3D do Google Maps:ele demonstra o potencial dos dados de mapeamento em 3D do Google para criar mapas imersivos e interativos.

Primeiros passos:

Ativar

Principais tecnologias

Essa solução foi criada usando duas tecnologias principais:

APIs da Plataforma Google Maps:

Usamos várias APIs da Plataforma Google Maps para receber o mapa básico e os dados e criar essa experiência:

  • Blocos fotorrealistas em 3D do Google Maps: modelos 3D de alta resolução de construções e terrenos oferecem uma representação realista e visualmente envolvente dos ambientes urbanos.
  • API Places: o app pode identificar e mostrar informações detalhadas sobre pontos de interesse (PDIs) na área explorada, enriquecendo a experiência do usuário com conhecimento local.
  • O preenchimento automático ajuda os usuários a pesquisar locais ou áreas de interesse específicas.

CesiumJS

A CesiumJS é responsável por renderizar e exibir o globo 3D de alta resolução. Ele processa o carregamento e a visualização dos blocos fotorrealistas em 3D do Google, que oferecem um modelo em malha 3D de construções e terrenos.

Gerenciamento da câmera:o CesiumJS fornece as ferramentas para controlar a posição, a orientação e o movimento da câmera. Isso inclui:

  • Definir o ponto de vista inicial para focar a vizinhança especificada durante o carregamento do app.
  • Implementar movimentos dinâmicos da câmera, como animações de órbita automatizadas para exploração.
  • Processamento de interações do usuário com o globo se esses recursos forem incluídos (movimentação, zoom, rotação)

Saiba como o bloco fotorrealista em 3D pode trabalhar com um renderizador de blocos 3D.

Principais componentes

O aplicativo é dividido em dois aplicativos diferentes:

  • App de administrador
  • App de demonstração

Este diagrama mostra uma visão geral das diferenças e a correlação entre os dois aplicativos:

imagem

Seria útil investigar cada app mais detalhadamente:

App de administrador

Este aplicativo oferece uma interface fácil de usar que permite personalizar a experiência 3D:

  • Pesquisa de local :use a barra de pesquisa integrada do Autocomplete da Plataforma Google Maps para encontrar a área que você quer mostrar. Depois de selecionar um local, a câmera voa sem problemas para essa área.

  • Câmera:ajuste a velocidade de movimento da câmera e o tipo de órbita para criar a experiência de visualização selecionada.

  • Lugares (PDIs): defina a densidade, o raio de pesquisa e os tipos de pontos de interesse (por exemplo, restaurantes, cafés, pontos de referência) que você quer incluir.

Use este app para personalizar a experiência dos seus usuários finais.

Há uma descrição detalhada de todas as personalizações do 3D Area Explorer.

App de demonstração

Este é o último aplicativo voltado para o usuário que carrega a configuração que você criou no app Admin. Nesse ambiente imersivo em 3D, os usuários poderão conhecer as áreas selecionadas e descobrir os lugares que você destacou.

Depois de personalizar a aparência usando o app Admin, faça o download da configuração e execute o app personalizado no código-fonte.

Experiência do usuário

imagem

Alguns dos principais recursos do aplicativo são:

  1. Os usuários podem explorar interativamente uma área em 3D, incluindo construções, pontos de referência e terrenos.
  2. Os usuários podem pesquisar e descobrir lugares por perto (por exemplo, museus, parques, restaurantes).
  3. Ao selecionar um lugar, os usuários podem visualizar informações detalhadas ou narrativas relacionadas a ele.

  4. Os desenvolvedores podem personalizar a experiência de análise detalhada usando configurações e controles (ao usar o app Admin).

  5. A rotação automática está ativada, permitindo que a câmera gire automaticamente em torno do centro da área selecionada.

Pré-requisitos

  1. Chave da API Google Maps: você precisará de uma chave de API válida com as seguintes APIs ativadas:

  2. Servidor da Web: é possível disponibilizar o aplicativo de:

    • Um servidor da Web local (por exemplo, usando Node.js, http-server)
    • Um serviço estático de hospedagem na Web (o aplicativo vem com um Dockerfile)

Você encontra uma descrição detalhada das opções de implantação na seção Leiame do projeto do GitHub.

implantação

É possível implantar o aplicativo como um aplicativo de nó ou um contêiner do Docker em qualquer ambiente de contêiner, como o GKE ou o GAE. A demonstração hospedada usa a seguinte arquitetura:

imagem

  • Nesta arquitetura, o código fica em um projeto do GitHub.
  • O Cloud Build coleta o código em qualquer envio para o principal e aciona uma operação de compilação.
  • Como parte do build, ele injeta chave de API e cria uma imagem, que é então armazenada no Artifact Registry.
  • Por fim, ele implanta a imagem estável mais recente do Artifact Registry no Cloud Run.
  • Também temos algumas verificações de integridade e monitoramento em execução para verificar a integridade dos aplicativos implantados.

Informações de faturamento

A solução 3D Area Explorer usa os serviços da Plataforma Google Maps para proporcionar uma experiência imersiva e dinâmica. Algumas APIs podem gerar cobranças. Confira a seguir uma visão geral das APIs e os links para os preços.

Plataforma Google Maps – API 3D Tiles:

A solução Storytelling usa a API 3D Tiles para melhorar a experiência visual com dados geoespaciais. Para conferir os detalhes sobre a API 3D Tiles, consulte Preços da API 3D Tiles da Plataforma Google Maps.

Plataforma Google Maps – API Places:

A API Places é empregada para dados baseados em localização, adicionando informações valiosas à experiência de narrativa. Para entender os custos associados à API Google Places,acesse Preços da API Places na Plataforma Google Maps.

Plataforma Google Maps – API Autocomplete:

O recurso de preenchimento automático melhora a interação do usuário. Para consultar detalhes sobre os preços da API Autocomplete do Google Maps, acesse Preços do Places Autocomplete da Plataforma Google Maps.

CesiumJS:

CesiumJS é usado para a visualização de globo em 3D. Embora o próprio CesiumJS tenha código aberto, recursos ou serviços adicionais podem ter seus próprios custos associados. Consulte a documentação do CesiumJS para conhecer as ofertas premium.

É fundamental analisar os preços de cada API, já que as cobranças são determinadas individualmente com base no uso. A Plataforma Google Maps oferece um nível sem custo financeiro com uma determinada quantidade de uso sem custos financeiros, e as especificações de preços podem variar de acordo com fatores como o número de solicitações e a região de uso.

Sempre consulte as páginas de preços oficiais para ver as informações mais precisas e atualizadas sobre os custos de uso da Plataforma Google Maps e da CesiumJS. Garanta a conformidade com os termos e condições descritos por esses serviços para gerenciar e entender de maneira eficaz as despesas associadas.

Conclusão

Este documento fornece uma visão geral dos recursos, componentes, experiência do usuário e requisitos técnicos do explorador de área 3D.

Usando os blocos fotorrealistas em 3D do Google e a API Places, ele permite conhecer bairros, descobrir pontos de interesse e aprender sobre a história local.

Seja para mostrar uma área, aprimorar a exploração ou promover a narrativa digital, o 3D Area Explorer oferece uma plataforma visualmente deslumbrante.

Teste a demonstração e personalize usando o app Admin para criar uma experiência 3D envolvente e informativa.