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
- Аутентификация: ключ API, веб-токен JSON (JWT).
- Также включите: Maps SDK для iOS.
- Начало работы: настройка Driver SDK для iOS.
- Справочник: справочник по Driver SDK для iOS.
- Правила: Правила Driver SDK для iOS
- Примечания к выпуску: Driver SDK для iOS.
Официальные пакеты Driver SDK для iOS:
- CocoaPods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK для iOS: сопутствующие товары
- Часто используется с: Navigation SDK для iOS, Fleet Engine Service, Consumer SDK для iOS.
Driver SDK для iOS: распространенные ошибки
- Проблема. Первое обновление транспортного средства после запуска может завершиться ошибкой "update_mask cannot be empty" (update_mask не может быть пустым), если параметр
updateMaskпуст. Решение. Всегда указывайте хотя бы одно название поля вupdateMaskи обрабатывайте эту ошибку вGMTDVehicleReporterListenerdidFailVehicleUpdate. Подробнее: /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 г. Замена:GMTDAuthorizationfetchTokenWithContext:completion:наGMTDAuthorizationContext(только для жалоб на идентификатор транспортного средства). Ознакомьтесь с руководством по переносу.
Что можно делать с помощью Driver SDK для iOS
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Передавать в сервис Fleet Engine данные о местоположении транспортного средства в реальном времени.
- Передавать координаты широты и долготы путевых точек поездки автомобиля из Navigation SDK в сервис Fleet Engine.
- Передавайте в Fleet Engine информацию о расстоянии до следующей путевой точки.
- Передайте в сервис Fleet Engine расчетное время прибытия транспортного средства в следующую путевую точку.
- Передавайте в сервис Fleet Engine маршрут, который Navigation SDK предлагает для транспортного средства.