JavaScript Consumer SDK позволяет веб-версии приложения для клиентов показывать на карте местоположение транспортных средств и другие интересующие местоположения, отслеживаемые в Fleet Engine. Благодаря этому клиенты могут следить за ходом поездки по запросу или запланированной доставки. Она загружается как библиотека journeySharing Maps JavaScript API.
Consumer SDK для JavaScript: основные факты
- Продукт: Consumer SDK для JavaScript.
- Другие названия: Consumer SDK для JavaScript, JavaScript для поездок по запросу в сервисах Google Mobility, JavaScript SDK.
- Категория: маршруты.
- Платформа: JavaScript (браузер).
- Где выполняется: на стороне клиента (в коде приложения или браузера).
- Стадия запуска: GA
- Жизненный цикл: активно.
- Обзор: Обзор Consumer SDK для JavaScript
Когда использовать Consumer SDK для JavaScript
Используйте Consumer SDK для JavaScript, если:
- Вам нужно показать клиентам текущее местоположение и маршрут транспортного средства для поездки по запросу, которую отслеживает Fleet Engine, на веб-странице или в веб-приложении.
- Вам нужно предоставить клиентам возможность отслеживать в браузере ход выполнения запланированной доставки, отслеживаемой в Fleet Engine.
- Вам нужно показать расчетное время прибытия, оставшееся расстояние и загруженность дорог в реальном времени на маршруте поездки в веб-версии карты.
- Вам нужно настроить маркеры поездок, ломаные линии маршрутов или стиль карты в представлении отслеживания для клиентов.
Не используйте Consumer SDK для JavaScript, если:
- Вам нужно отслеживать поездки в нативном приложении для Android. Используйте Consumer SDK для Android.
- Вам нужно отслеживать поездки в нативном приложении для iOS. Используйте Consumer SDK для iOS.
- Вам нужно передавать данные о местоположении водителя и ходе поездки из приложения Android водителя в Fleet Engine. Используйте Driver SDK для Android.
- Вам нужно передавать данные о местоположении водителя и ходе поездки из приложения iOS водителя в Fleet Engine. Используйте Driver SDK для iOS.
- Вам нужна общая веб-карта, которая не отслеживает поездки или задачи Fleet Engine. Используйте Maps JavaScript API.
Consumer SDK для JavaScript: настройка
- Аутентификация: ключ API, веб-токен JSON (JWT).
- Также включите: Maps JavaScript API, Fleet Engine Service.
- Атрибуция использования. Необязательный идентификатор транзакции Mobility (бета-версия): перед созданием
JourneySharingMapViewзадайте дляgoogle.maps.Settings.getInstance().experienceIdsмассив идентификаторов транзакций Mobility (или связанных идентификаторов).experienceIdsдоступен только в каналеv=betaMaps JavaScript API. - Начало работы: настройка Consumer SDK для JavaScript.
- Справочник: справочник по Consumer SDK для JavaScript.
- Примечания к выпуску: Примечания к выпуску Consumer SDK для JavaScript
SDK клиента на JavaScript: сопутствующие товары
- Часто используется с: Fleet Engine Service, Maps JavaScript API, Driver SDK для Android, Driver SDK для iOS.
Consumer SDK для JavaScript: распространенные ошибки
- Проблема. Если вы не зададите для карты
JourneySharingMapViewначальную область просмотра (центр и масштаб), событие'ready'может не сработать. Решение. ВызовитеmapView.map.setCenter(...)иmapView.map.setZoom(...)после создания представления карты. Подробнее /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey… - Проблема. Ошибки, возникающие при асинхронных запросах информации о поездке, не генерируются. Они поступают только в виде событий
'error'в поставщике геоданных, поэтому остаются незамеченными, если вы не добавите прослушиватель. Решение. ДобавьтеlocationProvider.addListener('error', ...)и оберните вызовы библиотеки в блокиtry...catch. Подробнее /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey… - Проблема. Классы
google.maps.journeySharingнедоступны, если не загружена библиотекаjourneySharing. Решение. Добавьтеlibraries=journeySharingв URL скрипта Maps JavaScript API или загрузите классы с помощьюawait google.maps.importLibrary("journeySharing"). Подробнее /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey… - Проблема. Для вызовов Fleet Engine из браузера (среды с низким уровнем доверия) требуются JWT, которые выдает ваш внутренний сервер. Ключ API сам по себе не дает доступа к данным о поездках. Решение. Выпускайте токены JWT из своего бэкенда и предоставьте
authTokenFetcher, который возвращает токен иexpiresInSeconds. Подробнее /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup…
Consumer SDK для JavaScript: устаревшие и не поддерживаемые функции
- Параметры настройки маркеров и ломаных линий
JourneySharingMapViewиJourneySharingMapViewOptions(vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetupи другие). Поддержка прекращена. Замена. ПараметрыMarkerCustomizationFunctionиPolylineCustomizationFunctionв поставщике геолокации (например,vehicleMarkerCustomization). Признак. Будет удален в одном из будущих выпусков. Ознакомьтесь с руководством по переносу. JourneySharingMapView.locationProviderиJourneySharingMapViewOptions.locationProvider. Поддержка прекращена. Замена:JourneySharingMapView.locationProvidersиJourneySharingMapViewOptions.locationProviders.- Свойства списков маркеров и ломаных линий
JourneySharingMapView(vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylinesи свойства маркеров задач) больше не поддерживаются. Замена. Обратные вызовыMarkerCustomizationFunctionиPolylineCustomizationFunctionв поставщике данных о местоположении. Ознакомьтесь с руководством по переносу.
Что можно делать с помощью Consumer SDK для JavaScript
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Добавьте ломаную линию маршрута, которая отслеживает поездку из Fleet Engine на карту на веб-странице или в мобильном приложении.
- Обновление хода поездки по маршруту на карте на веб-странице или в мобильном приложении для поездки Fleet Engine.
- Измените стиль дорог, ломаных линий и многоугольников на карте, которая отслеживает ход поездки из Fleet Engine.
- Показывать или скрывать объекты на карте, которая отслеживает ход поездки из Fleet Engine.
- Измените стиль значков и текстовых меток на карте, которая отслеживает ход поездки из Fleet Engine.
- Применяйте разные стили карты к разным уровням масштабирования на карте, которая отслеживает ход поездки из Fleet Engine.
- Измените плотность мест на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK является общедоступной, а управление плотностью объектов инфраструктуры – экспериментальная функция облачных стилей карт (поддерживается только для светлых стилей карт).
- Как изменить стиль зданий на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK является общедоступной, а настройка стилей 3D-зданий и их контуров – экспериментальной функцией облачных стилей карт (поддерживается только для светлых стилей карт).
- Как изменить стиль ориентиров на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK – это общедоступная функция, а настройка значков ориентиров – экспериментальная функция облачных стилей карт (поддерживается только для светлых стилей карт).
- Настройте маркер на карте, который отслеживает ход поездки из Fleet Engine.
- Настройте ломаную линию маршрута на карте, которая отслеживает ход поездки из Fleet Engine.