Maps 3D SDK для iOS позволяет создавать 3D-карты в приложениях для iOS, используя 3D-изображения Google. Он предоставляет SwiftUI API для маркеров, всплывающих окон, ломаных линий, многоугольников, 3D-моделей (glTF), анимации траектории камеры, а также элементов управления камерой и взаимодействием.
Maps 3D SDK для iOS: основные факты
- Продукт: Maps 3D SDK для iOS.
- Категория: Карты
- Платформа: iOS.
- Где выполняется: на стороне клиента (в коде приложения или браузера).
- Стадия запуска: GA
- Жизненный цикл: активно.
- Обзор: Обзор Maps 3D SDK для iOS
Maps 3D SDK для iOS: когда использовать
Используйте Maps 3D SDK для iOS, если:
- Вам нужна интерактивная фотореалистичная 3D-карта в нативном приложении для iOS (SwiftUI).
- Вам нужно разместить маркеры, всплывающие окна, ломаные линии, многоугольники или 3D-модели glTF на 3D-карте в iOS.
- Вам нужно добавить анимацию камеры (пролет или облет) или ограничения камеры на 3D-карте в iOS.
- Вам нужно, чтобы пользователи могли нажимать на объекты на 3D-карте и видеть информацию о местах во встроенном виджете Places UI Kit.
Когда не следует использовать Maps 3D SDK для iOS
- Вам нужна 3D-карта в приложении для Android. Используйте Maps 3D SDK для Android.
- Вам нужна 3D-карта на веб-странице. Используйте Maps JavaScript API.
- Вам нужна стандартная двухмерная карта в приложении для iOS. Используйте Maps SDK для iOS.
Maps 3D SDK для iOS: настройка
- Сервис, который нужно включить:
mapsios.googleapis.com. - Аутентификация: ключ API.
- Начало работы: настройка Maps 3D SDK для iOS
- Справочник: справочник по Maps 3D SDK для iOS.
- Цены: использование Maps 3D SDK для iOS и оплата.
- Правила: правила Maps 3D SDK для iOS.
- Примечания к выпуску: Maps 3D SDK для iOS.
Официальные пакеты Maps 3D SDK для iOS:
- swift_package:
https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D) - swift_package:
https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)
Maps 3D SDK для iOS: сопутствующие товары
- Часто используется с Places SDK для iOS.
Maps 3D SDK для iOS: распространенные ошибки
- Проблема. Если при загрузке карты не задан режим карты, карта не загружается. Решение. При создании
Mapвсегда передавайте режим, напримерMap(mode: .hybrid). Подробнее /maps/documentation/maps-3d/ios-sdk/map-modes… - Проблема. Если задать ключ API и в точке входа приложения, и в отдельных представлениях карты, в консоли появится ошибка. Решение. Укажите
Map.apiKeyтолько в одном месте: в точке входа в приложение или в каждом представлении карты. Подробнее: /maps/documentation/maps-3d/ios-sdk/setup. - Проблема.
CameraaltitudeModeигнорируется за пределами анимаций камеры и применяется только кflyCameraToиflyCameraAround. Решение. Если вы используетеCameraaltitudeMode, перейдите наflyCameraToилиflyCameraAround. Подробнее /maps/documentation/maps-3d/ios-sdk/custom-camera-paths… - Проблема. В
GoogleMaps3DKitвиджет Places UI по умолчанию показывается, когда пользователь нажимает на объект инфраструктуры. Решение. Чтобы скрыть виджет, используйтеplaceInformationEnabled(false)или возвращайте.noneизonPlaceTap(_:). Подробнее: /maps/documentation/maps-3d/ios-sdk/points-of-interest.
Что можно делать с помощью Maps 3D SDK для iOS
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Добавьте на веб-страницу интерактивную фотореалистичную 3D-карту.
- Добавьте маркер на фотореалистичную 3D-карту.
- Настройте маркер на фотореалистичной 3D-карте.
- Добавьте 3D-модель на фотореалистичную 3D-карту.
- Добавьте 3D-ломаную на фотореалистичную 3D-карту.
- Добавьте 3D-многоугольник на фотореалистичную 3D-карту.
- Реагируйте на действия пользователей и события на фотореалистичной 3D-карте.
- Настройте элементы управления, которые будут показываться на фотореалистичной 3D-карте.
- Управляйте траекторией камеры и анимацией на фотореалистичной 3D-карте.
- Как управлять ограничениями камеры на фотореалистичной 3D-карте