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

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: настройка

Официальные пакеты 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: распространенные ошибки

  • Проблема. Если при загрузке карты не задан режим карты, карта не загружается. Решение. При создании Map всегда передавайте режим, например Map(mode: .hybrid). Подробнее /maps/documentation/maps-3d/ios-sdk/map-modes…
  • Проблема. Если задать ключ API и в точке входа приложения, и в отдельных представлениях карты, в консоли появится ошибка. Решение. Укажите Map.apiKey только в одном месте: в точке входа в приложение или в каждом представлении карты. Подробнее: /maps/documentation/maps-3d/ios-sdk/setup.
  • Проблема. Camera altitudeMode игнорируется за пределами анимаций камеры и применяется только к flyCameraTo и flyCameraAround. Решение. Если вы используете Camera altitudeMode, перейдите на 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

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