Fleet Tracking - On Demand Rides & Delivery (beta)

FleetEngineVehicleLocationProvider 类

google.maps.journeySharing.FleetEngineVehicleLocationProvider 类

车辆位置信息提供程序。

此类扩展了 PollingLocationProvider。

通过调用 const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
参数： 
为车队引擎车辆创建新的位置信息提供程序。
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
参数： 
返回值：None
多段线自定义函数，用于根据速度读数为有效多段线着色。将此函数指定为 FleetEngineVehicleLocationProviderOptions.activePolylineCustomization，以便为有效多段线渲染感知交通状况的多段线。
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
参数： 
返回值：None
多段线自定义函数，用于根据速度读数为剩余多段线着色。将此函数指定为 FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization，以便为其余多段线渲染感知交通状况的多段线。
staleLocationThresholdMillis
类型：  number
此字段为只读字段。车辆位置信息过时阈值。如果车辆的最后更新位置超过此阈值，系统将不会显示该车辆。
vehicleId
类型：  string
此位置信息提供程序所监控的车辆的 ID。设置此字段以跟踪车辆。
继承： isPolling、pollingIntervalMillis
继承： addListener
error
function(event)
参数： 
当位置信息提供程序遇到错误时触发的事件。
update
function(event)
参数： 
在车队引擎数据更新请求完成时触发的事件。
继承： ispollingchange

FleetEngineVehicleLocationProviderOptions 接口

google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions 接口

车辆位置信息提供程序的选项。
authTokenFetcher
类型：  AuthTokenFetcher
提供 JSON Web 令牌，用于对 Fleet Engine 进行客户端身份验证。
projectId
类型：  string
Google Cloud 控制台中的使用方的项目 ID。
activePolylineCustomization optional
类型：  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
应用于有效多段线的自定义设置。有效的多段线对应于车辆当前正在穿越的路线的一部分。

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

    如需查看所提供参数及其用法列表，请参阅 VehiclePolylineCustomizationFunctionParams。
destinationMarkerCustomization optional
应用于车辆行程目的地标记的自定义设置。

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

    如需查看所提供参数及其用法列表，请参阅 VehicleWaypointMarkerCustomizationFunctionParams。
intermediateDestinationMarkerCustomization optional
应用于车辆行程中途目的地标记的自定义设置。

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

    如需查看所提供参数及其用法列表，请参阅 VehicleWaypointMarkerCustomizationFunctionParams。
originMarkerCustomization optional
应用于车辆行程起点标记的自定义设置。

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

    如需查看所提供参数及其用法列表，请参阅 VehicleWaypointMarkerCustomizationFunctionParams。
pollingIntervalMillis optional
类型：  number optional
提取位置信息更新之间的最短时间（以毫秒为单位）。如果提取位置信息更新所需的时间超过 pollingIntervalMillis，则系统会等到当前位置信息更新完成后再开始下一个位置信息更新。

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

默认的轮询间隔为 5000 毫秒，即最短间隔。如果您将轮询间隔设置为较低的非零值，系统会使用 5000。
remainingPolylineCustomization optional
类型：  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
自定义应用于其余多段线。剩余的多段线对应于车辆尚未开始穿越的路线部分。

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

    如需查看所提供参数及其用法列表，请参阅 VehiclePolylineCustomizationFunctionParams。
staleLocationThresholdMillis optional
类型：  number optional
车辆位置信息过时阈值。如果车辆的最后更新位置超过此阈值，系统将不会显示该车辆。默认值为 24 小时（以毫秒为单位）。如果阈值小于 0 或为 Infinity，系统会忽略该阈值，并且不会将车辆位置信息视为过时。
takenPolylineCustomization optional
类型：  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
应用于所绘制多段线的自定义设置。所采集的多段线对应于车辆已经过的路线的一部分。

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

    如需查看所提供参数及其用法列表，请参阅 VehiclePolylineCustomizationFunctionParams。
vehicleId optional
类型：  string optional
在位置信息提供程序实例化后立即跟踪的车辆 ID。如果未指定，位置信息提供程序不会开始跟踪任何车辆；请使用 FleetEngineVehicleLocationProvider.vehicleId 设置 ID 并开始跟踪。
vehicleMarkerCustomization optional
类型：  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
应用于车辆标记的自定义设置。

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

    如需查看所提供参数及其用法列表，请参阅 VehicleMarkerCustomizationFunctionParams。

FleetEngineVehicleLocationProviderUpdateEvent 接口

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent 接口

在触发 FleetEngineVehicleLocationProvider.update 事件时传递给事件处理脚本的事件对象。
trips optional
类型：  Array<Trip> optional
此车辆完成的行程列表。不可修改。
vehicle optional
类型：  Vehicle optional
更新返回的车辆数据结构。不可修改。

FleetEngineFleetLocationProvider 类

google.maps.journeySharing.FleetEngineFleetLocationProvider 类

车队位置信息提供程序。

此类扩展了 PollingLocationProvider。

通过调用 const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing") 进行访问。请参阅 Maps JavaScript API 中的库。
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
参数： 
为由车队引擎跟踪的车辆创建新的位置信息提供程序。
locationRestriction
类型：  LatLngBounds|LatLngBoundsLiteral optional
用于跟踪车辆的边界。如果未设置边界，系统将不会跟踪任何车辆。如需跟踪所有车辆（无论其位置如何），请将边界设置为等同于整个地球。
staleLocationThresholdMillis
类型：  number
此字段为只读字段。车辆位置信息过时阈值。如果车辆的最后更新位置超过此阈值，系统将不会显示该车辆。
vehicleFilter
类型：  string optional
提取车辆时应用的过滤条件。
继承： isPolling、pollingIntervalMillis
继承： addListener
update
function(event)
参数： 
在车队引擎数据更新请求完成时触发的事件。
继承： ispollingchange

FleetEngineFleetLocationProviderOptions 接口

google.maps.journeySharing.FleetEngineFleetLocationProviderOptions 接口

车队位置信息提供程序的选项。
authTokenFetcher
类型：  AuthTokenFetcher
提供 JSON Web 令牌，用于对 Fleet Engine 进行客户端身份验证。
projectId
类型：  string
Google Cloud 控制台中的使用方的项目 ID。
locationRestriction optional
类型：  LatLngBounds|LatLngBoundsLiteral optional
在实例化位置信息提供程序后立即跟踪车辆的纬度/经度边界。如果未设置，位置信息提供程序不会开始跟踪任何车辆；请使用 FleetEngineFleetLocationProvider.locationRestriction 设置边界并开始跟踪。如需跟踪所有车辆（无论其位置如何），请将边界设置为等同于整个地球。
staleLocationThresholdMillis optional
类型：  number optional
车辆位置信息过时阈值。如果车辆的最后更新位置超过此阈值，系统将不会显示该车辆。默认值为 24 小时（以毫秒为单位）。如果阈值小于零或为 Infinity，系统会忽略该阈值，并且不会将车辆位置视为过时。
vehicleFilter optional
类型：  string optional
提取车辆时要应用的过滤查询。此过滤器会直接传递给车队引擎。

如需了解支持的格式，请参阅 ListVehiclesRequest.filter。

请注意，属性的有效过滤条件必须带有“attributes”前缀。例如 attributes.x = "y" 或 attributes."x y" = "z"。
vehicleMarkerCustomization optional
类型：  function(VehicleMarkerCustomizationFunctionParams): void optional
应用于车辆标记的自定义设置。

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

    如需查看所提供参数及其用法列表，请参阅 VehicleMarkerCustomizationFunctionParams。

FleetEngineFleetLocationProviderUpdateEvent 接口

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent 接口

在触发 FleetEngineFleetLocationProvider.update 事件时传递给事件处理脚本的事件对象。
vehicles optional
类型：  Array<Vehicle> optional
查询返回的车辆列表。不可修改。