Позвольте клиентам отслеживать поездки по запросу, например доставку заказа, поездку на такси или другую услугу.
Что такое Consumer SDK?
Consumer SDK – это часть Fleet Engine для поездок по запросу. Он предоставляет интерфейсы, которые моделируют данные о поездках и отслеживают поездки в Fleet Engine, а также классы, которые вы используете для создания подробного отображения на основе карты, чтобы делиться поездками со своими пользователями. Чтобы создать такой интерфейс для потребителя, вы интегрируете Consumer SDK в свое приложение и настраиваете соответствующие профили ролей в Fleet Engine.
Consumer SDK содержит API для разных платформ, которые позволяют встраивать в приложения функцию отслеживания поездок. Consumer SDK доступен для следующих платформ:
Зачем использовать Consumer SDK?
Интеграция Consumer SDK в приложения для поездок по запросу позволяет предоставлять пользователям подробную информацию, включая обновления местоположения в реальном времени и привязку к дорогам. Пользователи могут видеть маршрут транспортного средства на карте, а также информацию о его продвижении, которая помогает понять, где находится их поездка или доставка.
Что можно делать с помощью Consumer SDK?
Вы можете использовать информацию из Driver SDK и Fleet Engine, чтобы создавать персонализированные функции для клиентов, в том числе:
Настройте интерфейс карты в соответствии с вашим брендом.
Отслеживайте текущее местоположение транспортного средства на маршруте. Данные о местоположении периодически обновляются.
Показывать расчетное время прибытия для мест посадки и высадки.
Покажи оставшееся расстояние.
Показывать загруженность дорог на маршруте.
Как работает 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
Выберите платформу, чтобы узнать, как начать отслеживать поездки в приложениях для пользователей.
Android
| 1 | Как настроить Consumer SDK для Android | Чтобы отслеживать поездки по запросу в приложении, настройте Consumer SDK. Подробнее о том, как получить Consumer SDK для Android… |
| 2 | Как настроить визуальный интерфейс | Чтобы настроить интерфейс для клиентов, определите карту и добавьте поддержку векторных карт. Подробнее о том, как настроить карту… |
| 3 | Как отслеживать поездку | Отслеживайте поездку, чтобы делиться местоположением транспортного средства с клиентом. Подробнее об отслеживании поездки… |
| 5 | Обновление статуса поездки и обработка ошибок | Обновляйте информацию о поездках, например расстояние и расчетное время прибытия, и устраняйте ошибки, возникающие во время поездки. Дополнительную информацию можно найти в статьях Обновление статуса поездки и Обработка ошибок поездки. |
| 5 | Как прекратить отслеживание поездки | Чтобы прекратить передачу геоданных транспортного средства клиенту, остановите отслеживание поездки. Подробнее о том, как прекратить отслеживание поездки… |
iOS
| 1 | Как настроить Consumer SDK для iOS | Чтобы отслеживать поездки по запросу в приложении, настройте Consumer SDK. Подробнее о том, как получить Consumer SDK для iOS… |
| 2 | Как настроить визуальный интерфейс | Инициализируйте представление карты и настройте обработку событий карты, чтобы создать интерфейс для потребителей. Подробнее о том, как настроить карту… |
| 3 | Как отслеживать поездку | Отслеживайте поездку, чтобы делиться местоположением транспортного средства с клиентом. Подробнее об отслеживании поездки… |
| 5 | Обновление статуса поездки и обработка ошибок | Обновляйте информацию о поездках, например расстояние и расчетное время прибытия, и устраняйте ошибки, возникающие во время поездки. Дополнительную информацию можно найти в разделах Обновление статуса поездки и Обработка ошибок поездки. |
| 5 | Как прекратить отслеживание поездки | Чтобы прекратить передачу геоданных транспортного средства клиенту, остановите отслеживание поездки. Подробнее о том, как прекратить отслеживание поездки… |
JavaScript
| 1 | Как настроить Consumer SDK в JavaScript | Чтобы отслеживать поездки по запросу в приложении, настройте Consumer SDK. Подробнее о том, как настроить Consumer 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 следуют этим правилам видимости для отслеживаемых объектов местоположения на карте. Если вы создаете собственный или производный поставщик геоданных, вы можете изменить правила видимости.
Транспортные средства видны только во время поездки. Транспортное средство видно с момента его назначения на поездку до момента высадки пассажира. Если поездка отменена, транспортное средство больше не видно.
Все остальные маркеры местоположения всегда видны. Все остальные маркеры местоположения для пунктов отправления и назначения, а также путевых точек всегда показываются на карте. Например, место высадки пассажира или доставки груза всегда показывается на карте, независимо от статуса поездки или доставки.
Дальнейшие действия
Ознакомьтесь с документацией для платформы, на которой вы хотите отслеживать поездки: