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: настройка
- Сервис, который нужно включить:
mapsandroid.googleapis.com. - Аутентификация: ключ API.
- Начало работы: настройка Maps 3D SDK для Android
- Справочная документация: справочная документация по Maps 3D SDK для Android.
- Цены: Использование и оплата Maps 3D SDK для Android
- Правила: правила Maps 3D SDK для Android.
- Примечания к выпуску: Maps 3D SDK для Android.
Официальные пакеты Maps 3D SDK для Android:
- maven:
com.google.android.gms:play-services-maps3d
Maps 3D SDK для Android: сопутствующие продукты
- Часто используется с: Places SDK для Android
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
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Добавьте на веб-страницу интерактивную фотореалистичную 3D-карту.
- Добавьте маркер на фотореалистичную 3D-карту.
- Настройте маркер на фотореалистичной 3D-карте.
- Добавьте 3D-модель на фотореалистичную 3D-карту.
- Добавьте 3D-ломаную на фотореалистичную 3D-карту.
- Добавьте 3D-многоугольник на фотореалистичную 3D-карту.
- Реагируйте на действия пользователей и события на фотореалистичной 3D-карте.
- Настройте элементы управления, которые будут показываться на фотореалистичной 3D-карте.
- Управляйте траекторией камеры и анимацией на фотореалистичной 3D-карте.
- Как управлять ограничениями камеры на фотореалистичной 3D-карте