Начало работы с 3D Area Explorer

Изображение

Обзор

Решение 3D Area Explorer позволяет по-новому исследовать места и получать о них представление. Это решение использует возможности фотореалистичной 3D-плитки платформы Google Карт и Places API, чтобы создавать привлекательные интерактивные 3D-среды.

3D Area Explorer можно использовать для разных целей:

  • Улучшенное исследование местности. Пользователи могут виртуально исследовать районы с высокой степенью визуальной детализации, получая представление о местных особенностях и достопримечательностях.

  • Продвижение историй, связанных с местоположением. Возможность добавлять объекты инфраструктуры с подробными описаниями позволяет создавать истории, которые обучают и информируют пользователей об определенных местах.

  • Вдохновлять разработчиков на использование 3D-возможностей Google Карт. Демонстрировать потенциал 3D-данных Google Карт для создания интерактивных карт с эффектом присутствия.

Начало работы

Включить

Основные технологии

Это решение основано на двух ключевых технологиях:

API платформы Google Карт

Чтобы получить базовую карту и данные для создания этого интерфейса, мы используем несколько API платформы Google Карт:

  • Фотореалистичные 3D-плитки Google Карт. Трехмерные модели зданий и рельефа с высоким разрешением обеспечивают реалистичное и визуально привлекательное представление городской среды.
  • Places API. Приложение может определять и показывать подробную информацию об объектах инфраструктуры в исследуемой области, обогащая пользовательский опыт местными знаниями.
  • Автозаполнение помогает пользователям искать определенные местоположения или интересующие их области.

CesiumJS

CesiumJS отвечает за рендеринг и показ глобуса в высоком разрешении. Она отвечает за загрузку и визуализацию фотореалистичных 3D-плиток Google, которые представляют собой трехмерную сетчатую модель зданий и рельефа.

Управление камерой. CesiumJS предоставляет инструменты для управления положением, ориентацией и движением камеры. Примеры:

  • Настройка начальной точки обзора, чтобы при загрузке приложения фокус был на указанном районе.
  • Реализация динамических движений камеры, например автоматической анимации вращения для исследования.
  • Обработка взаимодействий пользователя с глобусом, если такие функции включены (панорамирование, масштабирование, вращение).

Узнайте, как фотореалистичные 3D-плитки работают с рендерером 3D-плиток.

Основные элементы

Приложение разделено на две части:

  • Приложение для администратора
  • Демонстрационное приложение

На этой диаграмме показаны различия и взаимосвязь между двумя приложениями:

Изображение

Рекомендуем изучить каждое приложение подробнее:

Приложение для администратора

Это приложение предоставляет удобный интерфейс, позволяющий настраивать 3D-эффекты:

  • Поиск местоположения. Используйте встроенную строку поиска с автозаполнением на платформе Google Карт, чтобы найти нужную область. После выбора местоположения камера плавно переместится в эту область.

  • Камера. Настройте скорость движения камеры и тип орбиты, чтобы создать нужный эффект.

  • Места (объекты инфраструктуры). Определите плотность, радиус поиска и типы объектов инфраструктуры (например, рестораны, кафе, достопримечательности), которые вы хотите показать.

Используйте это приложение, чтобы настроить интерфейс для конечных пользователей.

Подробное описание всех настроек приведено в разделе Настройки 3D Area Explorer.

Демонстрационное приложение

Это пользовательское приложение, которое загружает конфигурацию, созданную в приложении для администратора. В этой иммерсивной 3D-среде пользователи смогут исследовать выбранные области и находить выделенные вами места.

Настроив внешний вид приложения в приложении для администратора, вы можете скачать конфигурацию и запустить собственное приложение из исходного кода.

Удобство для пользователей

Изображение

Вот некоторые из ключевых функций приложения:

  1. Пользователи могут интерактивно исследовать местность в 3D, включая здания, ориентиры и рельеф.
  2. Пользователи могут искать места поблизости, например музеи, парки и рестораны.
  3. Выбрав место, пользователи могут просмотреть подробную информацию или описания, связанные с этим местоположением.

  4. Разработчики могут персонализировать свои исследования с помощью настроек и элементов управления (если они используют приложение для администратора).

  5. Включен автоповорот, позволяющий камере автоматически поворачиваться вокруг центра выбранной области.

Требования

  1. Ключ Google Maps API. Вам потребуется действительный ключ API с включенными следующими API:

  2. Веб-сервер. Вы можете разместить приложение:

    • Локальный веб-сервер (например, Node.js, http-server).
    • Статический веб-хостинг (приложение поставляется с Dockerfile).

Подробное описание вариантов развертывания можно найти в разделе readme проекта GitHub.

Развертывание

Вы можете развернуть приложение как приложение Node или контейнер Docker в любой контейнерной среде, например GKE или GAE. В размещенной демоверсии используется следующая архитектура:

Изображение

  • В этой архитектуре код находится в проекте GitHub.
  • Cloud Build забирает код при каждом пуше в main и запускает операцию сборки.
  • В процессе сборки он внедряет ключ API и создает образ, который затем сохраняется в Artifact Registry.
  • Наконец, он развертывает последний стабильный образ из Artifact Registry в Cloud Run.
  • У нас также есть несколько проверок работоспособности и мониторинг для проверки работоспособности развернутых приложений.

Особенности оплаты

Решение 3D Area Explorer использует сервисы платформы Google Карт, чтобы обеспечить динамическое взаимодействие с эффектом присутствия. За использование некоторых API может взиматься плата. Ниже приведен обзор API и ссылки на цены.

Платформа Google Карт – 3D Tiles API

Решение 3D Area Explorer использует 3D Tiles API, чтобы улучшить визуальное представление геопространственных данных. Подробную информацию о ценах на 3D Tiles API можно найти в разделе Цены на 3D Tiles API на платформе Google Карт.

Платформа Google Карт – Places API

Places API используется для получения данных о местоположении, что позволяет обогатить информацию, предоставляемую 3D Area Explorer. Чтобы узнать о расходах, связанных с Google Places API, посетите страницу Цены на Places API на платформе Google Карт.

Платформа Google Карт – Autocomplete API

Функция автозаполнения улучшает взаимодействие с пользователем. Информацию о ценах на Google Maps Autocomplete API можно найти на странице Цены на Places Autocomplete.

CesiumJS

CesiumJS используется для визуализации 3D-глобуса. Хотя CesiumJS – это ПО с открытым исходным кодом, за дополнительные функции или сервисы может взиматься плата. Информацию о платных предложениях можно найти в документации CesiumJS.

Обязательно ознакомьтесь с ценами для каждого API, поскольку плата рассчитывается индивидуально в зависимости от использования. Обратите внимание, что на платформе Google Карт есть бесплатный план с определенным объемом использования, а цены могут варьироваться в зависимости от таких факторов, как количество запросов и регион использования.

Чтобы узнать точную и актуальную информацию о стоимости использования платформы Google Карт и CesiumJS, всегда обращайтесь к официальным страницам с ценами. Чтобы эффективно управлять расходами, соблюдайте условия использования этих сервисов.

Заключение

В этом документе описаны возможности, компоненты, пользовательский интерфейс и технические требования 3D Area Explorer.

Используя фотореалистичные 3D-плитки Google и Places API, оно позволяет виртуально исследовать районы, находить интересные места и узнавать о местной истории.

3D Area Explorer – это визуально привлекательная платформа, которая позволяет демонстрировать местность, улучшать навигацию и создавать цифровые истории.

Попробуйте демоверсию и настройте ее в приложении для администратора, чтобы создать увлекательную и информативную 3D-модель.