本文档介绍了如何为您在基于网络的历程跟踪应用中面向消费者用户所使用的地图自定义路线多段线。
借助 Consumer SDK,您可以控制路线多段线的可见性,或在地图上为行程路线设置路线多段线的样式。SDK 会为行程的有效路线或剩余路线中的每对坐标创建一个 google.maps.Polyline
对象。然后,该库会在以下两种情况下应用这些自定义设置:
- 然后再将对象添加到地图
- 对象数据发生更改时
设置路线多段线的样式
与设置标记的样式类似,您可以使用自定义参数设置路线多段线的样式。然后,您可以使用以下任一方法配置样式:
- 最简单:在创建或更新所有匹配的
Polyline
对象时,使用PolylineOptions
将对象应用于这些对象。 - 高级:指定自定义函数。借助自定义函数,您可以根据 Fleet Engine 发送的数据对对象进行单独的样式设置。该函数可以根据行程的当前状态更改每个对象的样式;例如,将
Polyline
对象着色设为较深的阴影,或在车辆行驶速度较慢时加深该对象。您甚至可以从 Fleet Engine 外部的来源进行联接,并根据该信息设置Polyline
对象的样式。
自定义参数
设置路线多段线的样式时,请使用 FleetEngineTripLocationProviderOptions
中提供的参数。这些参数用于提供车辆行程中的不同路径状态,如下所示:
- 已走过的路径:使用
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.trip.remainingWaypoints[0].distanceMeters;
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: TripPolylineCustomizationFunctionParams) => {
const distance = params.trip.remainingWaypoints[0].distanceMeters;
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};