本文档介绍了如何为面向消费者用户和车队运营商的基于 Web 的行程跟踪应用中使用的地图自定义路线多段线。
借助 Consumer SDK，您可以控制路线多段线的可见性，或为地图上行程路线的路线多段线设置样式。SDK 会为行程的有效路线或剩余路线中的每对坐标创建一个 google.maps.Polyline 对象。然后，该库会在以下两种情况下应用这些自定义设置：
- 将对象添加到地图之前
- 当用于对象的数据发生变化时
设置路线多段线的样式
与设置标记样式类似，您可以使用自定义参数设置路线多段线的样式。然后，您可以使用以下任一方法配置样式：
- 最简单：在创建或更新所有匹配的
Polyline对象时，使用PolylineOptions将对象应用于这些对象。 - 高级：指定自定义函数。借助自定义函数，您可以根据 Fleet Engine 发送的数据为对象设置个性化样式。该函数可以根据行程的当前状态更改每个对象的样式；例如，为
Polyline对象着色更深的阴影，或者在车辆行驶缓慢时使其更粗。您甚至可以与车队引擎之外的来源联接，并根据这些信息设置Polyline对象的样式。
自定义参数
设置路线多段线样式时，您可以使用 FleetEngineShipmentLocationProviderOptions 中提供的参数。这些参数用于提供车辆行程中的不同路径状态，如下所示：
- 已行过路径：使用
takenPolylineCustomization。 - 曾经去过的路径：使用
activePolylineCustomization。 - 尚未行驶路径：使用
remainingPolylineCustomization。
使用 PolylineOptions
以下示例展示了如何使用 PolylineOptions 为 Polyline 对象配置样式。按照此模式，使用前面列出的任意多段线自定义项自定义任何 Polyline 对象的样式。
JavaScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
TypeScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
使用自定义函数为路线多段线设置样式
以下示例展示了如何为有效路线多段线配置样式。按照此模式，您可以使用前面列出的任何路线多段线自定义参数自定义任何 Polyline 对象的样式。
JavaScript
// Color the route polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params) => {
const distance = params.taskTrackingInfo.remainingDrivingDistanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
TypeScript
// Color the route Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params: ShipmentPolylineCustomizationFunctionParams) => {
const distance = params.taskTrackingInfo.remainingDrivingDistanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
控制路线多段线的可见性
默认情况下，所有 Polyline 对象都是可见的。如需使 Polyline 对象不可见，请设置其 visible 属性：
JavaScript
remainingPolylineCustomization = {visible: false};
TypeScript
remainingPolylineCustomization = {visible: false};