Краткий справочник по Consumer SDK для JavaScript

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: настройка

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

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.