Introducción al Explorador de área 3D

imagen

Descripción general

La solución 3D Area Explorer te ofrece una forma completamente nueva de descubrir y experimentar ubicaciones. Esta solución aprovecha las capacidades de los mosaicos fotorrealistas en 3D de Google Maps Platform y la API de Places para crear entornos 3D interactivos y cautivadores.

El 3D Area Explorer está diseñado para cumplir con varios propósitos:

  • Mejora la exploración de áreas: Los usuarios pueden explorar vecindarios de forma virtual con un alto grado de detalle visual y obtener estadísticas sobre los lugares y los puntos de referencia locales.

  • Promover narrativas basadas en la ubicación: : La capacidad de incorporar lugares de interés con descripciones enriquecidas permite crear experiencias basadas en narrativas que educan y informan a los usuarios sobre ubicaciones específicas.

  • Inspira el desarrollo con las funciones en 3D de Google Maps: Muestra el potencial de los datos de mapas en 3D de Google para crear mapas interactivos y envolventes.

Primeros pasos:

Habilitar

Tecnologías clave

Esta solución está diseñada con dos tecnologías clave:

APIs de Google Maps Platform:

Usamos varias APIs de Google Maps Platform para obtener el mapa base y los datos necesarios para crear esta experiencia:

  • Mosaicos fotorrealistas en 3D de Google Maps: Los modelos 3D de alta resolución de edificios y terrenos proporcionan una representación realista y visualmente atractiva de los entornos urbanos.
  • API de Places: La app puede identificar y mostrar información detallada sobre los lugares de interés (POIs) dentro del área explorada, lo que enriquece la experiencia del usuario con conocimiento local.
  • Autocomplete ayuda a los usuarios a buscar ubicaciones o áreas de interés específicas.

CesiumJS

CesiumJS es responsable de renderizar y mostrar el globo terráqueo 3D de alta resolución. Controla la carga y la visualización de los mosaicos fotorrealistas en 3D de Google, que proporcionan un modelo de malla 3D de edificios y terrenos.

Administración de cámara: CesiumJS proporciona las herramientas para controlar la posición, la orientación y el movimiento de la cámara. Esto incluye lo siguiente:

  • Establecer el punto de vista inicial para que se enfoque en el vecindario especificado cuando se cargue la app
  • Implementar movimientos de cámara dinámicos, como las animaciones de órbita automáticas para la exploración
  • Controla las interacciones del usuario con el globo terráqueo si se incluyen esas funciones (desplazamiento lateral, zoom y rotación).

Obtén información sobre cómo los mosaicos fotorrealistas en 3D pueden funcionar con un renderizador de mosaicos 3D.

Componentes clave

La aplicación se divide en dos apps diferentes:

  • App de administración
  • App de demo

En este diagrama, se muestra una descripción general de las diferencias y la correlación entre las dos aplicaciones:

imagen

Sería beneficioso investigar cada aplicación con más detalle:

App de administración

Esta aplicación proporciona una interfaz fácil de usar que te permite personalizar la experiencia 3D:

  • Búsqueda de ubicación : Usa la barra de búsqueda integrada de Autocomplete de Google Maps Platform para encontrar el área que deseas mostrar. Una vez que selecciones una ubicación, la cámara volará a esa área sin problemas.

  • Cámara: Ajusta la velocidad de movimiento de la cámara y el tipo de órbita para crear la experiencia de visualización seleccionada.

  • Lugares (lugares de interés): Define la densidad, el radio de búsqueda y los tipos de puntos de interés (p.ej., restaurantes, cafeterías y lugares de interés) que deseas mostrar.

Usa esta app para personalizar la experiencia de tus usuarios finales.

Hay una descripción detallada de todas las personalizaciones en Personalizaciones del Explorador de áreas 3D.

App de demo

Esta es la aplicación final para el usuario que carga la configuración que creaste en la app de Administrador. En este entorno 3D envolvente, los usuarios podrán explorar las áreas seleccionadas y descubrir los lugares que destacaste.

Una vez que hayas personalizado el aspecto con la app de Admin, puedes descargar la configuración y ejecutar tu aplicación personalizada desde el código fuente.

Experiencia del usuario

imagen

Algunas de las funciones clave de la aplicación son las siguientes:

  1. Los usuarios pueden explorar de forma interactiva un área en 3D, incluidos edificios, puntos de referencia y terrenos.
  2. Los usuarios pueden buscar y descubrir lugares cercanos (p.ej., museos, parques y restaurantes).
  3. Cuando seleccionan un lugar, los usuarios pueden ver información detallada o narrativas relacionados con esa ubicación.

  4. Los desarrolladores pueden personalizar su experiencia de exploración a través de la configuración y los controles (si usan la app de administrador).

  5. La rotación automática está habilitada, lo que permite que la cámara rote automáticamente alrededor del centro del área seleccionada.

Requisitos previos

  1. Clave de API de Google Maps: Necesitarás una clave de API válida con las siguientes APIs habilitadas:

  2. Servidor web: Puedes entregar la aplicación desde cualquiera de los siguientes lugares:

    • Un servidor web local (p.ej., con Node.js o http-server)
    • Un servicio de alojamiento web estático (la aplicación viene con un Dockerfile)

Puedes encontrar una descripción detallada de las opciones de implementación en la sección readme del proyecto de GitHub.

Implementación

Puedes implementar la app como una aplicación de nodo o un contenedor de Docker en cualquier entorno de contenedor, como GKE o GAE. La demostración alojada usa la siguiente arquitectura:

imagen

  • En esta arquitectura, el código reside en un proyecto de GitHub.
  • Cloud Build recupera el código en cualquier envío a la rama principal y activa una operación de compilación.
  • Como parte de la compilación, inserta la clave de API y crea una imagen que luego se almacena en el registro de artefactos.
  • Por último, implementa la imagen estable más reciente de Artifact Registry en Cloud Run.
  • También tenemos algunas verificaciones de estado y una supervisión en ejecución para comprobar el estado de las apps implementadas.

Datos de facturación

La solución 3D Area Explorer usa los servicios de Google Maps Platform para proporcionar una experiencia dinámica y envolvente. Es posible que algunas APIs generen cargos. A continuación, se incluye una descripción general de las APIs y los vínculos a los precios.

Google Maps Platform: API de 3D Tiles:

La solución de narración utiliza la API de 3D Tiles para mejorar la experiencia visual con datos geoespaciales. Para obtener detalles sobre los precios relacionados con la API de 3D Tiles, consulta la sección Precios de la API de 3D Tiles de Google Maps Platform.

Google Maps Platform - API de Places:

La API de Places se usa para los datos basados en la ubicación, lo que agrega información enriquecida a la experiencia de narración. Para comprender los costos asociados con la API de Google Places,visita Google Maps Platform: Precios de la API de Places.

Google Maps Platform: API de Autocomplete

La función de autocompletar mejora la interacción del usuario. Para obtener detalles sobre los precios de la API de Google Maps Autocomplete, visita Google Maps Platform: Precios de Place Autocomplete.

CesiumJS:

CesiumJS se usa para la visualización del globo terráqueo en 3D. Si bien CesiumJS es de código abierto, es posible que las funciones o los servicios adicionales tengan sus propios costos asociados. Consulta la documentación de CesiumJS para conocer las ofertas premium.

Es fundamental revisar los detalles de los precios de cada API respectiva, ya que los cargos se determinan de forma individual según el uso. Ten en cuenta que Google Maps Platform ofrece un nivel gratuito con una cantidad determinada de uso sin costo, y los detalles de los precios pueden variar según factores como la cantidad de solicitudes y la región de uso.

Consulta siempre las páginas de precios oficiales para obtener la información más precisa y actualizada sobre los costos de uso de Google Maps Platform y CesiumJS. Asegúrate de cumplir con los términos y condiciones que describen estos servicios para administrar y comprender de manera eficaz los gastos asociados.

Conclusión

En este documento, se proporciona una descripción general de las capacidades, los componentes, la experiencia del usuario y los requisitos técnicos del explorador de áreas 3D.

Gracias a Photorealistic 3D Tiles de Google y la API de Places, permite explorar de forma virtual los vecindarios, descubrir lugares de interés y aprender sobre la historia local.

Ya sea para mostrar un área, mejorar la exploración o promover la narración digital, el Explorador de áreas 3D ofrece una plataforma visualmente impresionante.

Prueba la demostración y personalízala con la app de administrador para crear una experiencia 3D atractiva y informativa.