Introdução ao 3D Area Explorer

imagem

Visão geral

A solução 3D Area Explorer oferece uma maneira totalmente nova de descobrir e experimentar 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 Explorador de área em 3D foi desenvolvido para diversas finalidades:

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

  • Promova narrativas baseadas em local: a capacidade de incorporar PDIs (pontos de interesse) com descrições detalhadas permite a criação de experiências baseadas em 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 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 acessar 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 edifícios e terrenos fornecem uma representação realista e visualmente atraente de 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 (em inglês) ajuda os usuários a pesquisar locais ou áreas de interesse específicos.

CesiumJS

A CesiumJS é responsável por renderizar e exibir o globo 3D de alta resolução. Ela processa o carregamento e a visualização dos blocos fotorrealistas em 3D do Google, que fornecem um modelo de malha 3D de edifícios e terrenos.

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

  • Definir o ponto de vista inicial para se concentrar na vizinhança especificada ao carregar o app.
  • Implementação de movimentos dinâmicos da câmera, como animações de órbita automatizadas para exploração
  • Processar interações do usuário com o globo, se esses recursos estiverem incluídos (movimentação, zoom, rotação).

Saiba como os blocos fotorrealistas em 3D podem trabalhar com um renderizador de blocos 3D.

Principais componentes

O aplicativo é dividido em dois apps diferentes:

  • App Admin
  • App de demonstração

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

imagem

Seria útil investigar cada app mais detalhadamente:

App Admin

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

  • Pesquisa de local :use a barra de pesquisa integrada de preenchimento automático da Plataforma Google Maps para encontrar a área que você quer mostrar. Depois de selecionar um local, a câmera vai até essa área sem interrupções.

  • 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 destacar.

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

Há uma descrição detalhada de todas as personalizações das personalizações do Explorador de área em 3D.

App de demonstração

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

Depois de personalizar sua aparência usando o aplicativo Admin, faça o download da configuração e execute seu aplicativo personalizado a partir do código-fonte.

Experiência do usuário

imagem

Alguns dos principais recursos do aplicativo são:

  1. Os usuários podem explorar uma área em 3D de maneira interativa, incluindo edifícios, 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 conferir informações ou narrativas detalhadas relacionadas a ele.

  4. Os desenvolvedores podem personalizar a experiência de exploração usando configurações e controles (se estiverem usando o app Admin).

  5. A rotação automática é 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 válida com as seguintes APIs ativadas:

  2. Servidor da Web: você pode disponibilizar o aplicativo de:

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

É possível encontrar 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 pega o código em qualquer push para o main e aciona uma operação de build.
  • Como parte do build, ele injeta uma chave de API e cria uma imagem que é 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 conferir 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 uma visão geral das APIs e 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 detalhes de preços relacionados à API 3D Tiles, consulte Preços da API 3D Tiles da Plataforma Google Maps.

Plataforma Google Maps – API Places:

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

Plataforma Google Maps – API Autocomplete:

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

CesiumJS:

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

É crucial revisar os detalhes de 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 custos financeiros com determinada quantidade de uso, e os detalhes 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 conferir as informações mais precisas e atualizadas sobre os custos de uso da Plataforma Google Maps e da CesiumJS. Certifique-se de estar em conformidade com os termos e condições descritos por esses serviços para gerenciar e entender quaisquer despesas associadas de forma eficaz.

Conclusão

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

Com os blocos fotorrealistas em 3D do Google e a API Places, é possível explorar bairros virtualmente, descobrir pontos de interesse e aprender sobre a história local.

Seja para exibir uma área, aprimorar a exploração ou promover narrativas digitais, o 3D Area Explorer oferece uma plataforma com visual incrível.

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