Consumer SDK для iOS позволяет приложениям для клиентов на iOS отслеживать поездки по запросу в Fleet Engine. Его классы, такие как GMTCTripModel и GMTCJourneySharingSession, моделируют данные о поездке и показывают на карте местоположение транспортного средства, маршрут, расчетное время прибытия и оставшееся расстояние.
Consumer SDK для iOS: основные факты
- Продукт: Consumer SDK для iOS.
- Другое название: Consumer SDK для iOS.
- Категория: маршруты.
- Платформа: iOS.
- Где выполняется: на стороне клиента (в коде приложения или браузера).
- Стадия запуска: GA
- Жизненный цикл: активно.
- Обзор: Обзор Consumer SDK для iOS
Когда использовать Consumer SDK для iOS
Используйте Consumer SDK для iOS, если:
- Вам понадобится приложение для iOS, в котором клиенты смогут отслеживать поездку или доставку по запросу, выполняемую Fleet Engine.
- Вам нужно показать на карте в приложении для iOS текущее местоположение транспортного средства, его маршрут и загруженность дорог в реальном времени.
- Вам нужно показать расчетное время прибытия и оставшееся расстояние до места посадки и высадки для поездки по запросу в iOS.
- Вы уже используете Fleet Engine и Driver SDK для поездок по запросу и хотите добавить функцию передачи данных о поездке для клиентов.
Не используйте Consumer SDK для iOS, если:
- Вам нужно, чтобы потребители отслеживали запланированные задачи или поставки. Потребительский интерфейс для запланированных задач описан в документации по JavaScript. Используйте Consumer SDK для JavaScript.
- Вам нужно показывать ход выполнения поездки по запросу в приложении для Android. Используйте Consumer SDK для Android.
- Вам нужно показывать ход выполнения поездки по запросу в веб-приложении. Используйте JavaScript Consumer SDK.
- Вам нужно отправлять данные о местоположении водителя и статусе поездки из приложения водителя для iOS в Fleet Engine. Используйте Driver SDK для iOS.
Consumer SDK для iOS: настройка
- Аутентификация: веб-токен JSON (JWT).
- Также включите Fleet Engine Service.
- Начало работы: настройка Consumer SDK для iOS
- Справочная информация: справочник по Consumer SDK для iOS.
- Правила: правила Consumer SDK для iOS.
- Примечания к выпуску: Примечания к выпуску Consumer SDK для iOS
Официальные пакеты Consumer SDK для iOS:
- CocoaPods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
Consumer SDK для iOS: сопутствующие товары
- Часто используется с: Fleet Engine Service, Driver SDK для iOS, Driver SDK для Android, Maps SDK для iOS.
Consumer SDK для iOS: распространенные ошибки
- Проблема. Мониторинг поездки завершается ошибкой 401
UNAUTHENTICATED, если JWT подписан без идентификатора поездки или срок его действия истек. Решение. Поставщик токенов (GMTCAuthorization) должен возвращать JWT, выпущенный для идентификатора поездки в контексте авторизации, кешировать его для каждой поездки и обновлять по истечении срока действия. См. /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk. - Проблема. Мониторинг поездки завершается ошибкой 400
INVALID_ARGUMENT, если название поездки не соответствует форматуproviders/{provider_id}/trips/{trip_id}. Решение. Используйте идентификатор проекта Google Cloud в качествеprovider_idи передайте тот же идентификатор проекта в качествеproviderIDпри инициализации SDK. Подробнее /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk. - Проблема. Приложение продолжает ожидать обновления после завершения или отмены поездки. Решение. Вызовите
unregisterSubscriberв модели поездки, когда поездка завершена или отменена. Подробнее: /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey. - Проблема. При установке XCFramework вручную не добавляются необходимые пакеты ресурсов и настройки сборки, если вы не добавите их в Xcode. Решение. По возможности используйте CocoaPods. При установке вручную добавьте в проект
gRPCCertificates.bundleиGoogleRidesharingConsumer.bundle, свяжите указанные фреймворки и добавьте-ObjCв Other Linker Flags (Другие флаги компоновщика) для отладки и выпуска. Подробнее: /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.
Consumer SDK для iOS: устаревшие и не поддерживаемые функции
- Инициализатор
GMTSVehicleLocation-initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:. Поддержка прекращена 1 июня 2025 г. Замена:GMTSVehicleLocation-initWithOptions:наGMTSVehicleLocationOptions. [GMTCMapView initWithCoder]: поддержка прекращена 1 декабря 2023 г. Замена:GMTCMapView-initWithOptions:.
Что можно делать с помощью Consumer SDK для iOS
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Добавьте настраиваемую интерактивную карту, которая отслеживает ход поездки от Fleet Engine до мобильного приложения.
- Добавьте ломаную линию маршрута, которая отслеживает поездку из Fleet Engine на карту на веб-странице или в мобильном приложении.
- Обновление хода поездки по маршруту на карте на веб-странице или в мобильном приложении для поездки Fleet Engine.
- Измените стиль дорог, ломаных линий и многоугольников на карте, которая отслеживает ход поездки из Fleet Engine.
- Показывать или скрывать объекты на карте, которая отслеживает ход поездки из Fleet Engine.
- Измените стиль значков и текстовых меток на карте, которая отслеживает ход поездки из Fleet Engine.
- Применяйте разные стили карты к разным уровням масштабирования на карте, которая отслеживает ход поездки из Fleet Engine.
- Измените плотность мест на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK является общедоступной, а управление плотностью объектов инфраструктуры – экспериментальная функция облачных стилей карт (поддерживается только для светлых стилей карт).
- Как изменить стиль зданий на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK является общедоступной, а настройка стилей 3D-зданий и их контуров – экспериментальной функцией облачных стилей карт (поддерживается только для светлых стилей карт).
- Как изменить стиль ориентиров на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK – это общедоступная функция, а настройка значков ориентиров – экспериментальная функция облачных стилей карт (поддерживается только для светлых стилей карт).
- Настройте маркер на карте, который отслеживает ход поездки из Fleet Engine.
- Настройте ломаную линию маршрута на карте, которая отслеживает ход поездки из Fleet Engine.