Краткий справочник по Maps 3D SDK для Android

Maps 3D SDK для Android позволяет приложениям Android показывать интерактивные 3D-карты, созданные на основе 3D-изображений Google. Она предоставляет маркеры, всплывающие окна, ломаные линии, многоугольники, 3D-модели glTF, анимацию траектории камеры и элементы управления для взаимодействия с пользователем и движения камеры.

Maps 3D SDK для Android: основные факты

  • Продукт: Maps 3D SDK для Android.
  • Другое название: Maps 3D Android SDK.
  • Категория: Карты
  • Платформа: Android.
  • Где выполняется: на стороне клиента (в коде приложения или браузера).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Maps 3D SDK для Android
  • Регионы: ограниченное количество. Доступность зависит от страны и региона. См. столбец Maps 3D (JavaScript, Android, iOS) на странице покрытия платформы Google Карт. (подробнее о покрытии)

Maps 3D SDK для Android: когда использовать

Используйте Maps 3D SDK для Android, если:

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

Не используйте Maps 3D SDK для Android, если:

  • Вы создаете веб-приложение, в котором нужны 3D-карты. Используйте Maps JavaScript API.
  • Вы создаете приложение для iOS, в котором нужны 3D-карты. Используйте Maps 3D SDK для iOS.
  • Вам нужна готовая к выпуску стандартная двухмерная карта улиц в приложении для Android (режим ROADMAP в этом SDK является экспериментальным). Используйте Maps SDK для Android.

Maps 3D SDK для Android: настройка

Официальные пакеты Maps 3D SDK для Android:

  • maven: com.google.android.gms:play-services-maps3d

Maps 3D SDK для Android: распространенные ошибки

  • Проблема. Если при загрузке карты не указан ее режим, она не загружается. Решение. Всегда задавайте Map3DMode (SATELLITE, HYBRID или ROADMAP) в XML-файле макета (map3d:mapMode) или с помощью setMapMode/Map3DInitConfig. Подробнее: /maps/documentation/maps-3d/android-sdk/map-modes.
  • Проблема. Прослушиватели кликов (по карте и маркерам) не запускаются в основном потоке UI, поэтому прямые обновления интерфейса из обработчика не выполняются. Решение. Переключитесь на основной поток перед обновлением интерфейса, например с помощью lifecycleScope.launch(Dispatchers.Main). Подробнее: /maps/documentation/maps-3d/android-sdk/add-a-marker.
  • Проблема. Состояние карты используется в нескольких экземплярах Map3DView, поэтому маркеры, оверлеи и положение камеры переносятся из старого представления в новое. Решение. Оставьте только один активный экземпляр Map3DView. Вызовите onDestroy() для старого экземпляра, вручную удалите маркеры и оверлеи и сбросьте настройки камеры с помощью GoogleMap3D. Подробнее о том, /maps/documentation/maps-3d/android-sdk/add-a-3d-map…
  • Проблема. По умолчанию при нажатии на объект инфраструктуры на базовой карте показывается виджет Places UI, для которого также требуется зависимость Places SDK. Решение. Добавьте зависимость Places SDK для Android и возвращайте true из onMap3DClick в OnMap3DClickListener, чтобы подавить виджет по умолчанию, если он вам не нужен. Подробнее: /maps/documentation/maps-3d/android-sdk/points-of-interest.

Что можно делать с помощью Maps 3D SDK для Android

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.