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

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

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

  • CocoaPods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

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

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