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