TrackLineOptions

TrackLine构造函数options参数。

承载单条轨迹的本地回放：线样式、痕迹（已走过/未走过分色）、序列箭头纹理、渐变色、播放控制、自动跟随视野、车辆图标。线样式命名与 PolylineLayer 对齐。

interface TrackLineOptions {
    autoFollow?: boolean;
    autoStart?: boolean;
    data?: any;
    duration?: number;
    followOptions?: TrackLineFollowOptions;
    idKey?: string;
    isLinear?: boolean;
    linearTexture?: [number, string][];
    lineVisible?: boolean;
    maxZoom?: number;
    minZoom?: number;
    movePoint?: boolean | GroundPoint | Marker | TrackLineMovePointOptions;
    opacity?: number;
    passedColor?: string | false;
    referCenter?: Point;
    renderStage?: RenderStage;
    speedMode?: 0 | 1;
    strokeColor?: string;
    strokeLineCap?: "round" | "butt" | "square";
    strokeLineJoin?: "round" | "miter" | "bevel";
    strokeTextureColor?: string;
    strokeTextureGap?: number;
    strokeTextureHeight?: number;
    strokeTextureSpaced?: boolean;
    strokeTextureUrl?: string;
    strokeTextureWidth?: number;
    strokeWeight?: number;
    timestampKey?: string;
    upcomingColor?: string | false;
    visible?: boolean;
    zIndex?: number;
}

属性

#autoFollow?: boolean

是否让地图视野自动跟随车辆，默认值：false

#autoStart?: boolean

setData 后是否自动开始播放，默认值：false

#data?: any

初始数据，同 TrackLine.setData 的入参

#duration?: number

播放总时长（秒）默认值：60

#followOptions?: TrackLineFollowOptions

跟随细节，见 TrackLineFollowOptions

#idKey?: string

取要素 id 的字段名，默认值：'id'

#isLinear?: boolean

true 时线色沿轨迹按 linearTexture 渐变（覆盖 strokeColor）默认值：false

#linearTexture?: [number, string][]

渐变色标 [[位置0~1, css 颜色], ...]，如 [[0, 'green'], [1, 'red']]

#lineVisible?: boolean

整条线是否可见，false 时只留车辆图标，默认值：true

#maxZoom?: number

最大显示缩放等级，默认值：21

#minZoom?: number

最小显示缩放等级，默认值：3

#movePoint?: boolean | GroundPoint | Marker | TrackLineMovePointOptions

车辆图标：false 不创建；对象按 TrackLineMovePointOptions 创建；也可直接传已构造的 GroundPoint / Marker 实例

#opacity?: number

图层级透明度 [0,1]，默认值：1

#passedColor?: string | false

已走过路段颜色。css 色染色 / null 跟随主线色 / 'none' / 'transparent' / alpha 为 0 隐藏，默认值：'rgba(153, 153, 153, 1)'

#referCenter?: Point

图层参考中心点，规避大坐标浮点抖动

#renderStage?: RenderStage

绘制阶段，取值见 RenderStage

#speedMode?: 0 | 1

1 按时间戳变速（还原真实速度）；0 匀速，默认值：1

#strokeColor?: string

线颜色，css 字符串，默认值：'rgba(25, 25, 250, 1)'

#strokeLineCap?: "round" | "butt" | "square"

线端点样式，默认值：'round'

#strokeLineJoin?: "round" | "miter" | "bevel"

拐角连接样式，默认值：'round'

#strokeTextureColor?: string

纹理叠加色，默认值：'rgba(255, 255, 255, 1)'

#strokeTextureGap?: number

相邻纹理间隔（px），仅 strokeTextureSpaced 为 true 时生效，默认值：16

#strokeTextureHeight?: number

纹理原图高（px）默认值：16

#strokeTextureSpaced?: boolean

true 按 strokeTextureGap 间隔平铺；false 沿线连续拉伸，默认值：false

#strokeTextureUrl?: string

纹理图片地址（必须是竖图），空则不启用，默认值：''

#strokeTextureWidth?: number

纹理原图宽（px）默认值：16

#strokeWeight?: number

线宽（屏幕 px，全宽）默认值：8

#timestampKey?: string

时间戳字段名，properties[timestampKey] 应为与 coordinates 等长的数组；缺失则降级匀速，默认值：'timestamps'

#upcomingColor?: string | false

未走过路段颜色，取值同 passedColor；'none' 可做出线随车"生长"的效果，默认值：null

#visible?: boolean

是否显示，默认值：true

#zIndex?: number

显示层级，小的先画，默认值：1