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

Driver SDK для iOS – это набор инструментов для мобильных приложений и компонент Fleet Engine. Он отправляет в Fleet Engine данные о местоположении автомобиля, маршруте, путевых точках, оставшемся расстоянии и расчетном времени прибытия из Navigation SDK для поездок по запросу и запланированных задач.

Driver SDK для iOS: основные факты

  • Продукт: Driver SDK для iOS.
  • Другие названия: Driver SDK, Driver SDK для поездок по запросу, Driver SDK для запланированных задач.
  • Категория: маршруты.
  • Платформа: iOS.
  • Где выполняется: на стороне клиента (в коде приложения или браузера).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Driver SDK для iOS

Когда использовать Driver SDK для iOS

Используйте Driver SDK для iOS, если:

  • Чтобы отправлять в Fleet Engine данные о местоположении транспортного средства в реальном времени, вам понадобится приложение для водителей на iOS.
  • Вам нужно передавать в Fleet Engine из Navigation SDK данные о маршруте, путевых точках, оставшемся расстоянии и расчетном времени прибытия.
  • Вам нужно, чтобы водители могли управлять назначенными поездками по запросу и пользоваться навигацией в одном приложении, не переключаясь между приложениями.
  • Вы создаете приложение для водителей, которое будет работать с запланированными задачами Fleet Engine на iOS.

Когда не следует использовать Driver SDK для iOS

  • Вам нужна только пошаговая навигация в приложении iOS, без отслеживания Fleet Engine. Используйте Navigation SDK для iOS.
  • Вам нужно показывать пассажиру или клиенту ход поездки или доставки в приложении для пользователей. Используйте Consumer SDK для iOS.
  • Вам нужно отправлять обновления данных о транспортных средствах, кроме местоположения и маршрута. Они передаются через ваш сервер в Fleet Engine. Используйте Fleet Engine Service.
  • Приложение для водителей работает на Android. Используйте Driver SDK для Android.

Настройка Driver SDK для iOS

Официальные пакеты Driver SDK для iOS:

  • CocoaPods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

Driver SDK для iOS: распространенные ошибки

  • Проблема. Первое обновление транспортного средства после запуска может завершиться ошибкой "update_mask cannot be empty" (update_mask не может быть пустым), если параметр updateMask пуст. Решение. Всегда указывайте хотя бы одно название поля в updateMask и обрабатывайте эту ошибку в GMTDVehicleReporterListener didFailVehicleUpdate. Подробнее: /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot.
  • Проблема. GMSRoadSnappedLocationProvider не отправляет обновления местоположения, если устройство не перемещалось с момента последнего обновления, например когда водитель ждет. Решение. Чтобы отправить новое уведомление о местоположении, когда устройство неподвижно, остановите, а затем запустите GMSRoadSnappedLocationProvider (с уже добавленным слушателем GMTDVehicleReporter). Подробнее: /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready.
  • Проблема. Приложение для пользователей неверно отображает поездку, если координаты, переданные в setDestinations(), не соответствуют путевой точке поездки. Решение. Убедитесь, что широта и долгота, переданные в setDestinations(), соответствуют координатам путевой точки поездки в Fleet Engine. Подробнее: /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details.
  • Проблема. Использование оператора оптимистичной версии (~>) может привести к непредсказуемым, неповторяющимся сборкам, а отсутствие версии загружает новейший SDK, который может включать критические изменения или повышать минимальную версию iOS. Carthage не поддерживается. Решение. Закрепите точную версию Driver SDK в CocoaPods или Swift Package Manager и проверяйте примечания к выпуску перед обновлением. Подробнее: /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.

Driver SDK для iOS: устаревшие и прекращенные функции

  • Класс GMTSVehicleMatch. Поддержка прекращена. Замена. В Driver SDK замена не требуется (сопоставление транспортных средств выполняется в Fleet Engine). Признак. Устарело в Driver SDK для iOS версии 2.2.0 и удалено из текущей справки по Driver SDK. Ознакомьтесь с руководством по переносу.
  • GMTSServiceType и fetchAuthTokenForServiceType:authorizationContext:completion:. Поддержка прекращена 29 ноября 2021 г. Замена: GMTDAuthorization fetchTokenWithContext:completion: на GMTDAuthorizationContext (только для жалоб на идентификатор транспортного средства). Ознакомьтесь с руководством по переносу.

Что можно делать с помощью Driver SDK для iOS

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