Trip and Order Progress

FleetEngineTripLocationProvider 类

google.maps.journeySharing.FleetEngineTripLocationProvider 类

行程位置信息提供程序。

此类扩展了 PollingLocationProvider。

使用 &libraries=journeySharing 网址参数加载。请参阅 Maps JavaScript API 中的库。

使用 v=beta 时，可通过调用 const {FleetEngineTripLocationProvider} = await google.map.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
参数：
为 Fleet Engine 行程创建新的位置信息提供程序。
tripId
类型：string
此位置信息提供程序观察的行程的 ID。设置此字段以开始跟踪。
继承的设置： isPolling
refresh
refresh()
参数：无
返回值：void
明确刷新所跟踪的位置。
继承的设置： addListener
error
function(event)
参数：
营业地点提供商遇到错误时触发的事件。
update
function(event)
参数：
Fleet Engine 数据更新请求完成时触发的事件。
继承的设置： ispollingchange

FleetEngineTripLocationProviderOptions 接口

google.maps.journeySharing.FleetEngineTripLocationProviderOptions接口

行程位置信息提供程序的选项。

使用 &libraries=journeySharing 网址参数加载。请参阅 Maps JavaScript API 中的库。
authTokenFetcher
提供 JSON Web 令牌，用于向 Fleet Engine 对客户端进行身份验证。
projectId
类型：string
来自 Google Cloud Console 的使用方的项目 ID。
destinationMarkerCustomization optional
类型：(function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
已对目标标记应用自定义设置。

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

    如需查看提供的参数及其用途的列表，请参阅 TripMarkerCustomizationFunctionParams。
originMarkerCustomization optional
类型：(function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
自定义已应用于源标记。

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

    如需查看提供的参数及其用途的列表，请参阅 TripMarkerCustomizationFunctionParams。
pollingIntervalMillis optional
类型：number optional
获取位置信息更新之间的最短时间（以毫秒为单位）。如果获取位置更新所花费的时间超过 pollingIntervalMillis，则在当前位置更新完成之前，不会启动下一次位置更新。

如果将此值设为 0，系统会停用周期性位置信息更新。如果位置信息提供程序观察到的任何参数发生更改，系统会提取新的位置信息更新。

默认的轮询时间间隔为 5000 毫秒（最小间隔）。如果您将轮询间隔设置为较低的非零值，则系统会使用 5000。
tripId optional
类型：string optional
在实例化营业地点提供商后立即跟踪的行程 ID。如果未指定，位置信息提供程序不会开始跟踪任何行程；请使用 FleetEngineTripLocationProvider.tripId 设置 ID 并开始跟踪。
vehicleMarkerCustomization optional
类型：(function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
已应用于车辆标记的自定义。

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

    如需查看提供的参数及其用途的列表，请参阅 TripMarkerCustomizationFunctionParams。
waypointMarkerCustomization optional
已将自定义设置应用到航点标记。

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

    如需查看提供的参数及其用途的列表，请参阅 TripWaypointMarkerCustomizationFunctionParams。

FleetEngineTripLocationProviderUpdateEvent 接口

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent接口

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

使用 &libraries=journeySharing 网址参数加载。请参阅 Maps JavaScript API 中的库。
trip optional
类型：Trip optional
更新返回的行程结构。无法修改。