
Descripción general
La solución Explorador de áreas en 3D te brinda 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 Explorador de áreas en 3D 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, lo que les permite obtener información sobre las características y los puntos de referencia locales.
Promover narrativas basadas en la ubicación: La capacidad de incorporar lugares de interés (POI) con descripciones enriquecidas permite crear experiencias basadas en narrativas que educan e informan a los usuarios sobre ubicaciones específicas.
Inspirar el desarrollo con las funciones de Google Maps 3D: Demuestra el potencial de los datos de mapas en 3D de Google para crear mapas inmersivos e interactivos.
Cómo comenzar
Habilitar
Tecnologías clave
Esta solución se compila 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 para crear esta experiencia:
- Mosaicos fotorrealistas en 3D de Google Maps: Los modelos en 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 (POI) dentro del área explorada, lo que enriquece la experiencia del usuario con conocimientos locales.
- La función Autocomplete ayuda a los usuarios a buscar ubicaciones o áreas de interés específicas.
CesiumJS
CesiumJS se encarga de renderizar y mostrar el globo terráqueo en 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 los edificios y el terreno.
Administración de la 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 enfocarse en el vecindario especificado cuando se carga la app
- Implementar movimientos dinámicos de la cámara, como las animaciones de órbita automatizadas para la exploración
- Controlar 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 en 3D.
Componentes clave
La aplicación se divide en dos apps diferentes:
- Aplicación 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:

Sería beneficioso investigar cada app más a fondo:
Aplicación de administración
Esta aplicación proporciona una interfaz fácil de usar que te permite personalizar la experiencia en 3D:
Búsqueda de ubicación : Usa la barra de búsqueda integrada de Autocomplete de Google Maps Platform para encontrar el área que quieres mostrar. Una vez que selecciones una ubicación, la cámara se desplazará sin problemas a esa área.
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 (PI): Define la densidad, el radio de búsqueda y los tipos de puntos de interés (p.ej., restaurantes, cafeterías, puntos de referencia) que deseas mostrar.
Usa esta app para personalizar la experiencia de tus usuarios finales.
Explora la oficina de Google en Chicago siguiendo una trayectoria de cámara lenta.
Consulta Una vista densa de las atracciones turísticas alrededor de Las Vegas Strip.
Ahora, explora Las Vegas siguiendo una ruta de cámara sinusoidal de alta velocidad.
Explora el Gran Cañón con todas las atracciones turísticas clave.
Hay una descripción detallada de todas las personalizaciones en Personalizaciones del Explorador de áreas en 3D.
App de demo
Esta es la aplicación final para el usuario que carga la configuración que creaste en la app de administración. En este entorno envolvente en 3D, 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 administración, podrás descargar la configuración y ejecutar tu aplicación personalizada desde el código fuente.
Experiencia del usuario

Estas son algunas de las funciones clave de la aplicación:
- Los usuarios pueden explorar un área de forma interactiva en 3D, incluidos edificios, puntos de referencia y terrenos.
- Los usuarios pueden buscar y descubrir lugares cercanos (p.ej., museos, parques y restaurantes).
Cuando seleccionan un lugar, los usuarios pueden ver información detallada o narrativas relacionadas con esa ubicación.
Los desarrolladores pueden personalizar su experiencia de exploración a través de parámetros de configuración y controles (si usan la app de administrador).
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
Clave de API de Google Maps: Necesitarás una clave de API válida con las siguientes APIs habilitadas:
Servidor web: Puedes entregar la aplicación desde cualquiera de las siguientes opciones:
- Un servidor web local (p.ej., con Node.js, http-server)
- Un servicio de hosting web estático (la aplicación incluye un Dockerfile)
Puedes encontrar una descripción detallada de las opciones de implementación en la sección Léame 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 contenedores, como GKE o GAE. La demostración alojada usa la siguiente arquitectura:

- En esta arquitectura, el código reside en un proyecto de GitHub.
- Cloud Build recoge 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, se inserta la clave de API y se crea una imagen que, luego, se almacena en Artifact Registry.
- Por último, implementa la imagen estable más reciente de Artifact Registry en Cloud Run.
- También tenemos algunas verificaciones de estado y supervisión en ejecución para comprobar el estado de las apps implementadas.
Datos de facturación
La solución Explorador de áreas en 3D usa los servicios de Google Maps Platform para proporcionar una experiencia envolvente y dinámica. Es posible que algunas APIs generen cargos. Aquí tienes una descripción general de las APIs y vínculos a los precios.
Google Maps Platform: API de 3D Tiles
La solución Explorador de áreas en 3D 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 página 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 del Explorador de áreas en 3D. Para comprender los costos asociados con la API de Google Places, visita Precios de la API de Places en Google Maps Platform.
Google Maps Platform: API de Autocomplete
La función Autocompletar mejora la interacción del usuario. Para obtener detalles sobre los precios de la API de Place Autocomplete de Google Maps, visita la página de Google Maps Platform sobre los 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, las funciones o los servicios adicionales pueden tener sus propios costos asociados. Consulta la documentación de CesiumJS para conocer las ofertas premium.
Es fundamental revisar los detalles de precios de cada API, 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 cierta cantidad 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 se describen en estos servicios para administrar y comprender los gastos asociados de manera eficaz.
Conclusión
En este documento, se proporciona una descripción general de las funciones, los componentes, la experiencia del usuario y los requisitos técnicos del Explorador de áreas en 3D.
Aprovecha los mosaicos fotorrealistas en 3D y la API de Places de Google para permitir la exploración virtual de vecindarios, el descubrimiento de lugares de interés y el aprendizaje sobre la historia local.
Ya sea para mostrar un área, mejorar la exploración o promover la narración digital, el Explorador de áreas en 3D ofrece una plataforma visualmente impresionante.
Prueba la demostración y personalízala con la app de administración para crear una experiencia en 3D atractiva e informativa.