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