JavaScript 消费者 SDK 快速参考

借助 JavaScript Consumer SDK,基于 Web 的消费者应用可以在地图上显示 Fleet Engine 中跟踪的车辆位置和其他感兴趣的位置,以便消费者跟踪按需行程或预定配送的进度。它会作为 Maps JavaScript API 的 journeySharing 库加载。

JavaScript Consumer SDK:关键信息

  • 产品:JavaScript Consumer SDK
  • 别名:Consumer SDK for JavaScript、Mobility Services 按需行程 JavaScript、JavaScript SDK
  • 类别:路线
  • 平台:JavaScript(浏览器)
  • 运行位置:客户端(应用或浏览器代码)
  • 发布阶段:GA
  • 生命周期:有效
  • 概览:JavaScript 消费者 SDK 概览

JavaScript 消费者 SDK:适用情形

在以下情况下使用 JavaScript 消费者 SDK:

  • 您需要在网页或 Web 应用中向消费者显示 Fleet Engine 跟踪的按需行程的车辆实时位置和路线。
  • 您需要让消费者能够在浏览器中跟踪 Fleet Engine 中跟踪的预定配送的取货或送货进度。
  • 您需要在基于 Web 的地图视图中显示行程的预计到达时间、剩余距离和实时路况。
  • 您需要在 Web 消费者跟踪视图中自定义行程标记、路线多段线或地图样式。

在以下情况下,请勿使用 JavaScript 消费者 SDK:

  • 您需要在原生 Android 应用中提供行程跟踪消费者体验。请改用 Consumer SDK for Android。
  • 您需要在 iOS 原生应用中提供行程跟踪消费者体验。请改用 Consumer SDK for iOS。
  • 您需要通过司机的 Android 应用向 Fleet Engine 报告司机位置和行程进度。请改用 Driver SDK for Android。
  • 您需要通过司机的 iOS 应用向 Fleet Engine 报告司机位置和行程进度。请改用 Driver SDK for iOS。
  • 您需要一个不跟踪 Fleet Engine 行程或任务的通用 Web 地图。请改用 Maps JavaScript API。

JavaScript 消费者 SDK:设置

JavaScript 消费者 SDK:常见错误

JavaScript 消费端 SDK:旧版和已弃用的功能

  • 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 回调。请参阅迁移指南。

JavaScript 消费者 SDK 的用途

请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。