Адаптируйте пользовательский опыт для поездок по запросу, предоставив потребителям возможность следить за поездкой, чтобы сделать заказ, совершить поездку или получить другую услугу, которую вы им предоставляете.
Что такое Consumer SDK?
Consumer SDK — это часть Fleet Engine для поездок по запросу. Он предоставляет интерфейсы для моделирования данных о поездках и отслеживания поездок во Fleet Engine, а также классы для создания полнофункционального картографического представления данных о поездках для пользователей-потребителей. Вы интегрируете Consumer SDK в своё приложение и настраиваете соответствующие профили ролей во Fleet Engine для создания такого пользовательского опыта.
API-интерфейсы Consumer SDK, специфичные для конкретных платформ, позволяют вам встраивать возможность обмена информацией о путешествиях непосредственно в ваши приложения. Consumer SDK доступен для следующих платформ:
Зачем использовать Consumer SDK?
Интеграция Consumer SDK в ваши приложения для заказа поездок по запросу позволяет вам предоставлять клиентам комплексный опыт, включая обновления местоположения в режиме практически реального времени и привязку к дороге. Ваши клиенты смогут видеть маршрут транспортного средства, наложенный на карту, включая информацию о ходе поездки, которая помогает им понять, где находится их поездка или доставка.
Что можно сделать с помощью Consumer SDK?
Вы можете использовать информацию из Driver SDK и Fleet Engine для создания персонализированного пользовательского опыта, включая следующие функции:
Настройте пользовательский интерфейс карты в соответствии с потребностями вашего бренда.
Отслеживайте текущее местоположение транспортного средства по мере его движения по маршруту, при этом его положение периодически обновляется.
Показывать расчетное время прибытия (ETA) для мест посадки и высадки.
Показать оставшееся расстояние.
Показывать текущую ситуацию на маршруте.
Как работает Consumer SDK
На высоком уровне Consumer SDK опирается на следующие механизмы:
- Наличие соответствующих ролей Fleet Engine, чтобы аутентифицированное приложение могло отслеживать поездку, связанную с заказом потребителя.
- Связь между потребителем и поездкой, обеспечиваемая вашей внутренней системой.
- Классы SDK
TripModelиJourneySharingSession, которые моделируют данные о поездках и обмениваются сеансами поездок в потребительском приложении.
Consumer SDK также предоставляет другие интерфейсы и классы, позволяющие создавать насыщенные приложения, содержащие такие сведения, как дорожная информация, маркеры на карте, расчетное время прибытия и данные о маршруте.
В этой таблице показана схема поездки, сопровождаемая приложением потребителя.
| 1 | Приложение для потребителей запрашивает поездку | Ваш внутренний сервер получает запрос на поездку по требованию и выполняет следующие действия:
|
| 2 | Водитель принимает поездку | Приложение водителя получает идентификатор поездки и информацию о поездке, и водитель принимает поездку. |
| 3 | Приложение для потребителей запрашивает доступ для отслеживания поездки | Потребительское приложение получает идентификатор поездки из вашего бэкэнда и запрашивает разрешение на отслеживание поездки. |
| 4 | Водитель начинает поездку | Когда водитель использует приложение для уведомления о начале поездки, приложение уведомляет ваш внутренний сервер через Driver SDK. Например, когда водитель собирается покинуть ресторан или подъехать к месту посадки. |
| 5 | Fleet Engine начинает отправлять информацию о поездке | Fleet Engine начинает отслеживать поездку и делиться ее ходом с потребительским приложением. |
| 6 | Приложение для потребителей отображает информацию о поездке | Потребительское приложение уведомляет потребителя и начинает отображать ему информацию о поездке, обновляя ее по мере ее выполнения. |
| 7 | Поездка отменена или завершена | Когда водитель отменяет или завершает поездку, приложение водителя отключает отслеживание местоположения, а ваш внутренний сервер дает команду Fleet Engine отметить поездку как отмененную или завершенную. |
| 8 | Приложение для потребителей перестает отслеживать поездку | Поездка отображается как отмененная или завершенная. |
| 9 | Процесс повторяется для следующей поездки. | Создается новый рейс и процесс повторяется. |
Как использовать Consumer SDK
Выберите свою платформу, чтобы узнать, как начать отслеживать поездки в ваших потребительских приложениях.
Андроид
| 1 | Настройка Consumer SDK в Android | Чтобы отслеживать поездки по запросу в вашем приложении, настройте Consumer SDK. Подробнее см. в статье «Получить Android Consumer SDK» . |
| 2 | Настройте визуальный интерфейс | Создайте карту и добавьте поддержку векторных карт для настройки пользовательского опыта. Подробнее см. в разделе «Настройка карты» . |
| 3 | Следите за поездкой | Отслеживайте поездку, чтобы предоставить потребителю информацию о местоположении нужного транспортного средства. Подробнее см. в разделе «Отслеживание поездки» . |
| 5 | Обновлять ход поездки и обрабатывать ошибки поездки | Обновляйте информацию о своих поездках, такую как расстояние и предполагаемое время прибытия, а также устраняйте любые ошибки во время поездки. Подробнее см. в разделах «Обновление хода поездки» и «Обработка ошибок поездки» . |
| 5 | Когда поездка завершена, прекратите следовать | Остановите отслеживание поездки, чтобы прекратить передачу данных о местоположении транспортного средства вашему потребителю. Подробнее см. в разделе «Остановить отслеживание поездки» . |
iOS
| 1 | Настройка Consumer SDK в iOS | Чтобы отслеживать поездки по запросу в вашем приложении, настройте Consumer SDK. Подробнее см. в статье «Получить iOS Consumer SDK» . |
| 2 | Настройте визуальный интерфейс | Инициализируйте представление карты и обрабатывайте события карты, чтобы настроить пользовательский интерфейс. Подробнее см. в разделе «Настройка карты» . |
| 3 | Следите за поездкой | Отслеживайте поездку, чтобы предоставить потребителю информацию о местоположении нужного транспортного средства. Подробнее см. в разделе «Отслеживание поездки» . |
| 5 | Обновлять ход поездки и обрабатывать ошибки поездки | Обновляйте информацию о своих поездках, такую как расстояние и предполагаемое время прибытия, а также устраняйте любые ошибки во время поездки. Подробнее см. в разделах «Обновление хода поездки» и «Обработка ошибок поездки» . |
| 5 | Когда поездка завершена, прекратите следовать | Остановите отслеживание поездки, чтобы прекратить передачу данных о местоположении транспортного средства вашему потребителю. Подробнее см. в разделе «Остановить отслеживание поездки» . |
JavaScript
| 1 | Настройка Consumer SDK на JavaScript | Чтобы отслеживать поездки по запросу в вашем приложении, настройте Consumer SDK. Подробнее см. в статье Настройка JavaScript Consumer SDK . |
| 2 | Загрузите и настройте карту | Включите Maps JavaScript API и настройте авторизацию для настройки пользовательского опыта. Подробнее см. в разделе Настройка карты . |
| 3 | Следите за поездкой | Отслеживайте поездку, чтобы предоставить потребителю информацию о местоположении нужного транспортного средства. Подробнее см. в разделе «Отслеживание поездки» . |
| 5 | Обновлять ход поездки и обрабатывать ошибки поездки | Обновляйте информацию о своих поездках, такую как расстояние и предполагаемое время прибытия, а также устраняйте любые ошибки в поездках. Подробнее см. в разделах «Обновление и отслеживание хода поездки» и «Обработка ошибок в поездках» . |
| 5 | Когда поездка завершена, прекратите следовать | Остановите отслеживание поездки, чтобы прекратить передачу данных о местоположении транспортного средства вашему потребителю. Подробнее см. в разделе «Остановить отслеживание поездки» . |
Компоненты
В этом разделе обобщены два необходимых компонента для отслеживания поездки:
При желании вы также можете настроить свой пользовательский опыт с помощью следующих компонентов:
Сборщик токенов аутентификации
Чтобы контролировать доступ к данным о местоположении, хранящимся в Fleet Engine, необходимо выполнить следующие действия:
Реализуйте на своём сервере сервис создания JSON Web Token (JWT) для Fleet Engine. Подробнее см. в разделе «Выпуск JWT» .
Реализуйте сборщик токенов аутентификации в своих веб- или мобильных приложениях для аутентификации доступа к данным о местоположении. Подробнее о настройке сборщика токенов см. в руководстве по настройке для Android , iOS или JavaScript .
Просмотр карты и трекеры поездок
Отслеживание поездки включает в себя компоненты для визуализации транспортных средств и путевых точек, а также потоки необработанных данных о расчетном времени прибытия водителя или оставшемся расстоянии до места назначения.
В следующей таблице описаны эти компоненты:
| Компонент | Описание |
|---|---|
| Просмотр потребительской карты | Карта управляет жизненным циклом поездки, отображая путевые точки местоположения транспортных средств по мере её прохождения. Если маршрут транспортного средства известен, карта обновляет ломаную линию маршрута транспортного средства, отражая его перемещение по маршруту. |
| Поставщик местоположения поездки на JavaScript | В веб-приложениях JavaScript поставщик местоположения поездки передает информацию о местоположении отслеживаемых объектов на общую карту поездки. Подробнее см. в разделе Создание поставщика местоположения поездки . Поставщик местоположения поездки можно использовать для отслеживания следующих данных о поездке:
|
Отслеживаемые объекты местоположения
Поставщик местоположения отслеживает местоположение объектов, таких как путевые точки и транспортные средства, описанных в следующей таблице.
| Отслеживаемое местоположение | Описание |
|---|---|
| Место получения | Место отправления — это место, где начинается поездка. |
| Место назначения | Место назначения — это место окончания поездки. Оно обозначает место высадки. |
| Местоположение точки маршрута | Местоположение промежуточной точки — это любое промежуточное местоположение на маршруте отслеживаемой поездки. Хотя технически промежуточные точки могут включать места посадки и высадки, обычно они относятся к промежуточным остановкам на маршруте. Например, остановки между местами посадки и назначения на маршруте доставки являются местоположениями промежуточных точек. Подробнее см. в разделе «Путевые точки поездки» в документации Fleet Engine. |
| Местоположение транспортного средства | Местоположение транспортного средства — это указанное местоположение транспортного средства. Подробнее см. в разделе «Местоположение транспортного средства» в документации Fleet Engine. |
Создайте свой стиль карт
Стили маркеров и ломаных линий определяют внешний вид отслеживаемых объектов на карте. Вы можете использовать пользовательские параметры оформления, чтобы они соответствовали стилю вашего веб-приложения.
Контроль видимости отслеживаемых местоположений
Предопределенные поставщики местоположения в Fleet Engine следуют этим правилам видимости отслеживаемых объектов местоположения на карте. Если вы создаете пользовательский или производный поставщик местоположения, вы можете изменить правила видимости.
Транспортные средства видны только во время поездки : транспортное средство, участвующее в поездке, отображается с момента назначения его на рейс до момента высадки. Если поездка отменена, транспортное средство отображается дольше.
Все остальные маркеры местоположения всегда видны : все остальные маркеры местоположения для пунктов отправления, назначения и промежуточных точек всегда отображаются на карте. Например, место высадки или место доставки груза всегда отображается на карте, независимо от стадии поездки или доставки.
Что дальше?
Ознакомьтесь с документацией к платформе, на которой вы хотите следить за поездками: