Shipment Tracking

FleetEngineShipmentLocationProvider 类

google.maps.journeySharing.FleetEngineShipmentLocationProvider class
extends PollingLocationProvider
library "journeySharing"

配送位置信息提供方。

const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
参数:
为 Fleet Engine 配送跟踪创建新的位置信息提供程序。
trackingId
类型:string
此位置信息提供程序观察的任务的跟踪 ID。设置此字段即可开始跟踪。
继承的方法: isPolling、pollingIntervalMillis
refresh
refresh()
参数:无
返回值:void
明确刷新跟踪的位置。
继承: addListener
error
function(event)
参数:
当位置信息提供程序遇到错误时触发的事件。
update
function(event)
在 Fleet Engine 数据更新请求完成时触发的事件。
继承: ispollingchange

FleetEngineShipmentLocationProviderOptions 接口

google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions 接口

配送地点提供商的选项。

authTokenFetcher
提供 JSON Web 令牌,用于向 Fleet Engine 验证客户端身份。
projectId
类型:string
Google Cloud 控制台中的使用方项目 ID。
activePolylineCustomization
可选
自定义设置已应用于活动多段线。有效多段线对应于车辆当前正在行驶的路线部分。

使用此字段可指定自定义样式(例如多段线颜色)和可交互性(例如点击处理)。
  • 如果指定了 PolylineOptions 对象,则在创建多段线后,系统会将其中指定的更改应用于多段线,并覆盖其默认选项(如果存在)。
  • 如果指定了函数,则在创建多段线时会调用该函数一次。(在此调用中,函数形参对象中的 isNew 形参设置为 true。)此外,当多段线的坐标发生变化时,或者当位置信息提供程序从 Fleet Engine 接收数据时,无论与此多段线对应的数据是否发生变化,都会调用此函数。

    如需查看提供的形参及其用途的列表,请参阅 ShipmentPolylineCustomizationFunctionParams。
deliveryVehicleMarkerCustomization
可选
类型:(function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
应用于送货车辆标记的自定义设置。

使用此字段可指定自定义样式(例如标记图标)和互动性(例如点击处理)。
  • 如果指定了 MarkerOptions 对象,则在创建标记后,其中指定的更改会应用于该标记,并覆盖其默认选项(如果存在)。
  • 如果指定了函数,则在创建标记时,系统会在将标记添加到地图视图之前调用该函数一次。(在此调用中,函数参数对象中的 isNew 参数设置为 true。)此外,当位置信息提供程序从 Fleet Engine 接收数据时,无论与此标记对应的数据是否已更改,都会调用此函数。

    如需查看提供的参数及其用途的列表,请参阅 ShipmentMarkerCustomizationFunctionParams。
destinationMarkerCustomization
可选
类型:(function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
应用于目的地标记的自定义设置。

使用此字段可指定自定义样式(例如标记图标)和互动性(例如点击处理)。
  • 如果指定了 MarkerOptions 对象,则在创建标记后,其中指定的更改会应用于该标记,并覆盖其默认选项(如果存在)。
  • 如果指定了函数,则在创建标记时,系统会在将标记添加到地图视图之前调用该函数一次。(在此调用中,函数参数对象中的 isNew 参数设置为 true。)此外,当位置信息提供程序从 Fleet Engine 接收数据时,无论与此标记对应的数据是否已更改,都会调用此函数。

    如需查看提供的参数及其用途的列表,请参阅 ShipmentMarkerCustomizationFunctionParams。
pollingIntervalMillis
可选
类型:number optional
两次获取位置信息更新之间的最短时间间隔(以毫秒为单位)。如果获取位置信息更新的时间超过 pollingIntervalMillis,则在当前位置信息更新完成之前,系统不会启动下一次位置信息更新。

将此值设置为 0、无穷大或负值会停用自动位置信息更新。如果跟踪 ID 参数(例如,配送位置信息提供方的配送跟踪 ID)或过滤选项(例如,车队位置信息提供方的视口边界或属性过滤条件)发生变化,系统会获取一次新的位置信息更新。

默认和最小轮询间隔为 5000 毫秒。如果您将轮询间隔设置为较小的正值,系统会存储并使用 5000。
remainingPolylineCustomization
可选
应用于多段线其余部分的自定义设置。剩余多段线对应于车辆尚未开始行驶的路线部分。

使用此字段可指定自定义样式(例如多段线颜色)和可交互性(例如点击处理)。
  • 如果指定了 PolylineOptions 对象,则在创建多段线后,系统会将其中指定的更改应用于多段线,并覆盖其默认选项(如果存在)。
  • 如果指定了函数,则在创建多段线时会调用该函数一次。(在此调用中,函数形参对象中的 isNew 形参设置为 true。)此外,当多段线的坐标发生变化时,或者当位置信息提供程序从 Fleet Engine 接收数据时,无论与此多段线对应的数据是否发生变化,都会调用此函数。

    如需查看提供的形参及其用途的列表,请参阅 ShipmentPolylineCustomizationFunctionParams。
takenPolylineCustomization
可选
应用于所选多段线的自定义设置。已行驶多段线对应于车辆已行驶过的路线部分。

使用此字段可指定自定义样式(例如多段线颜色)和可交互性(例如点击处理)。
  • 如果指定了 PolylineOptions 对象,则在创建多段线后,系统会将其中指定的更改应用于多段线,并覆盖其默认选项(如果存在)。
  • 如果指定了函数,则在创建多段线时会调用该函数一次。(在此调用中,函数形参对象中的 isNew 形参设置为 true。)此外,当多段线的坐标发生变化时,或者当位置信息提供程序从 Fleet Engine 接收数据时,无论与此多段线对应的数据是否发生变化,都会调用此函数。

    如需查看提供的形参及其用途的列表,请参阅 ShipmentPolylineCustomizationFunctionParams。
trackingId
可选
类型:string optional
在位置信息提供程序实例化后立即跟踪的任务的跟踪 ID。如果未指定,位置信息提供程序不会开始跟踪任何任务;请使用 FleetEngineShipmentLocationProvider.trackingId 设置跟踪 ID 并开始跟踪。

FleetEngineShipmentLocationProviderUpdateEvent 接口

google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent 接口

触发 FleetEngineShipmentLocationProvider.update 事件时传递给事件处理脚本的事件对象。

taskTrackingInfo
可选
类型:TaskTrackingInfo optional
更新返回的任务跟踪信息结构。不可修改。