自定义路线多段线

请选择平台: Android iOS JavaScript

本文档介绍了如何为您在基于网络的历程跟踪应用中面向消费者用户所使用的地图自定义路线多段线。

借助 Consumer SDK,您可以控制路线多段线的可见性,或在地图上为行程路线设置路线多段线的样式。SDK 会为行程的有效路线或剩余路线中的每对坐标创建一个 google.maps.Polyline 对象。然后,该库会在以下两种情况下应用这些自定义设置:

  • 然后再将对象添加到地图
  • 对象数据发生更改时

设置路线多段线的样式

与设置标记的样式类似,您可以使用自定义参数设置路线多段线的样式。然后,您可以使用以下任一方法配置样式:

  • 最简单:在创建或更新所有匹配的 Polyline 对象时,使用 PolylineOptions 将对象应用于这些对象。
  • 高级:指定自定义函数。借助自定义函数,您可以根据 Fleet Engine 发送的数据对对象进行单独的样式设置。该函数可以根据行程的当前状态更改每个对象的样式;例如,将 Polyline 对象着色设为较深的阴影,或在车辆行驶速度较慢时加深该对象。您甚至可以从 Fleet Engine 外部的来源进行联接,并根据该信息设置 Polyline 对象的样式。

自定义参数

设置路线多段线的样式时,请使用 FleetEngineTripLocationProviderOptions 中提供的参数。这些参数用于提供车辆行程中的不同路径状态,如下所示:

使用 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};