1. LineLayer

Extends: Layer

1.1. 初始化 new LineLayer(options)

线图层,可实现线图层数据的添加、移除、缩放至和显隐等操作

Example

//通过图层管理类统一创建线图层
let lineLayer = geomap.layerManager.createLayer(BOSGeo.LayerType.LINE, 'testLine',{ customGroupId:"vector"});

1.2. 属性

1.3. 方法

1.3.1. lineLayer.add(options) ⇒ Line

添加线

Example

//创建线图层：lineLayer
lineLayer.add({
    positions: [[115.054437, 25.551279, 48], [115.07, 25.279, 48]],
    width: 10,
    isReverse: true,
    customMaterial: BOSGeo.CustomLineMaterial.LineArrowMaterial
});
lineLayer.add({
    positions: [[115.054437, 25.51279, 48], [115.07, 25.279, 48], [115.017, 25.1279, 48]],
    width: 10,
    isReverse: true,
    customMaterial: BOSGeo.CustomLineMaterial.LineDashMaterial
});

1.3.2. lineLayer.addArcline(options) ⇒Line

添加抛物线（适用于单个数据的添加管理，不适用于批量线的一次性加载）

Example

lineLayer.addArcline({
    startPosition: [115.054437, 25.551279, 48],
    endPosition: [115.07, 25.279, 48],
    width: 10,
    isReverse: true,
    customMaterial: BOSGeo.CustomLineMaterial.LineFlowMaterial
});

1.3.3. lineLayer.loadGeoJson(options) ⇒ Primitive | GroundPolylinePrimitive

通过GeoJson对象批量添加线要素对象 ( 适用于大体量geojson数据的解析 初始解析时间相较于loadInCollection会慢一些，实现方法与loadInBatch一致， 优势：加载完后性能较好，且不需要直接解析geojson数据 缺点：目前只支持颜色、线宽的个性化设置，且仅支持EPSG:4326的geojson数据 )

Example

BOSGeo.Resource.fetchJson({
    url: 'http://bosgeo.boswinner.com/geoData/geojson/shenzhen_road_11893.geojson'
}).then((res) => {
    const primitive = lineLayer.loadGeoJson({
        geojson: res,
        featureKey: 'osm_id',
        expressionTable: {
            "'${bz}' === '高速公路'": {
                color: BOSGeo.Color.RED,
                width: 6
            },
            "'${bz}' === '一级公路'": {
                color: BOSGeo.Color.YELLOW,
                width: 5
            },
            "'${bz}' === '二级公路'": {
                color: BOSGeo.Color.ORANGE,
                width: 4
            },
            "'${bz}' === '三级公路'": {
                color: BOSGeo.Color.BLUE,
                width: 3
            },
            "true": {
                color: BOSGeo.Color.GREEN,
                width: 2
            }
        }
    });
});

1.3.4. lineLayer.loadInBatch(options) ⇒ Primitive | GroundPolylinePrimitive

同批次加载线要素对象 ( 适用于大体量非geojson或不是EPSG:4326坐标系的geojson数据的解析 初始解析时间相较于loadInCollection会慢一些，实现方法与loadGeoJson一致， 优势：加载完后性能较好，可个性化调整要素属性 缺点：目前只支持颜色、线宽的个性化设置，且需要额外的转换工作 )

Example

BOSGeo.Resource.fetchJson({
    url: 'http://bosgeo.boswinner.com/geoData/geojson/shenzhen_road_11893.geojson'
}).then((res) => {
    const {features} = res;
    const propertiesList = [];
    const featurePositions = [];
    var outline;
    features.forEach((feature) => {
        const {geometry, properties} = feature;
        const {coordinates, type} = geometry;
        switch (type) {
            case 'LineString':
                outline = [];
                coordinates.forEach((point) => {
                    outline.push(BOSGeo.Cartesian3.fromDegrees(point[0], point[1], 1));
                });
                featurePositions.push(outline);
                propertiesList.push(properties);
                break;
            case 'MultiLineString':
                coordinates.forEach((polygon) => {
                    outline = [];
                    polygon.forEach((point) => {
                        outline.push(BOSGeo.Cartesian3.fromDegrees(point[0], point[1], 1));
                    });
                    featurePositions.push(outline);
                    propertiesList.push(properties);
                });
                break;
        }
    });
    const primitive = lineLayer.loadInBatch({
        positions: featurePositions,
        propertiesList: propertiesList,
        clampToGround: false,
        featureKey: 'osm_id',
        expressionTable: {
            "'${bz}' === '高速公路'": {
                color: BOSGeo.Color.RED,
                width: 6
            },
            "'${bz}' === '一级公路'": {
                color: BOSGeo.Color.YELLOW,
                width: 5
            },
            "'${bz}' === '二级公路'": {
                color: BOSGeo.Color.ORANGE,
                width: 4
            },
            "'${bz}' === '三级公路'": {
                color: BOSGeo.Color.BLUE,
                width: 3
            },
            "true": {
                color: BOSGeo.Color.GREEN,
                width: 2
            }
        }
    });
});

1.3.5. lineLayer.loadInCollection(options) ⇒ PolylineCollection

批量加载线要素对象 ( 该方法适用于小体量数据的批量加载和个性化展示， 实现方法与loadGeoJson、loadInBatch完全不同。 优势：初始加载十分快速，支持同一类型材质的个性化展示、要素级别的可视距离控制等。 缺点：要素量达到几千时可能会引起性能问题，且只支持空间线无法贴模型贴地形 )

Example

var expressionTable = {
    "'${bz}' === '高速公路'": {
        width: 6,
        maxVisibleDistance: 50000,
        customMaterial: new BOSGeo.CustomLineMaterial({
            type: BOSGeo.CustomMaterialType.LINE_FLOW,
            color: BOSGeo.Color.RED, //若要显示图片本身的颜色，需将该颜色参数设置为透明色 BOSGeo.Color.TRANSPARENT,
            speedFactor: 6,
            imagePath: 'https://bosgeo.boswinner.com/Assets/Images/green_line.png'
        }),
    },
    "'${bz}' === '一级公路'": {
        width: 5,
        maxVisibleDistance: 25000,
        customMaterial: new BOSGeo.CustomLineMaterial({
            type: BOSGeo.CustomMaterialType.LINE_DASH,
            color: BOSGeo.Color.YELLOW,
            dashLength: 8,
            dashPattern: parseInt("10011111111001", 2)
        }),
    },
    "'${bz}' === '二级公路'": {
        width: 4,
        maxVisibleDistance: 18000,
        customMaterial: new BOSGeo.CustomLineMaterial({
            type: BOSGeo.CustomMaterialType.LINE_GROW,
            color: BOSGeo.Color.ORANGE,
            glowPower: 0.5,
            taperPower: 0.9
        }),
    },
    "'${bz}' === '三级公路'": {
        width: 3,
        maxVisibleDistance: 14000,
        customMaterial: new BOSGeo.CustomLineMaterial({
            type: BOSGeo.CustomMaterialType.LINE_ARROW,
            color: BOSGeo.Color.BLUE,
        })
    },
    "true": {
        width: 2,
        maxVisibleDistance: 10000,
        customMaterial: new BOSGeo.CustomLineMaterial({
            type: BOSGeo.CustomMaterialType.LINE_COLOR,
            color: BOSGeo.Color.GREEN,
        }),
    }
}
BOSGeo.Resource.fetchJson({
    url: 'http://bosgeo.boswinner.com/geoData/geojson/shenzhen_road_2514.geojson'
}).then((res) => {
    const {features} = res;
    const propertiesList = [];
    const featurePositions = [];
    var outline;
    features.forEach((feature) => {
        const {geometry, properties} = feature;
        const {coordinates, type} = geometry;
        switch (type) {
            case 'LineString':
                outline = [];
                coordinates.forEach((point) => {
                    outline.push(BOSGeo.Cartesian3.fromDegrees(point[0], point[1], 1));
                });
                featurePositions.push(outline);
                propertiesList.push(properties);
                break;
            case 'MultiLineString':
                coordinates.forEach((polygon) => {
                    outline = [];
                    polygon.forEach((point) => {
                        outline.push(BOSGeo.Cartesian3.fromDegrees(point[0], point[1], 1));
                    });
                    featurePositions.push(outline);
                    propertiesList.push(properties);
                });
                break;
        }
    });
    const primitive = lineLayer.loadInCollection({
        positions: featurePositions,
        propertiesList: propertiesList,
        featureKey: 'osm_id',
        expressionTable,
    });
    lineLayer.flyToBatchedLine(primitive.primitiveId)
});

1.3.6. lineLayer.flyToBatchedFeature()

定位到指定属性key值的要素对象(批量添加的线要素)

1.3.7. lineLayer.flyToBatchedLine(primitiveId)

定位到批量线的范围

1.3.8. lineLayer.flyToLine(line, options)

定位到单独添加的线对象

1.3.9. lineLayer.zoomToLayer(callback)

缩放至本图层

1.3.10. lineLayer.removeBatchedLine(primitiveId) ⇒ Boolean

移除批量线

1.3.11. lineLayer.remove(line)

根据对象移除

1.3.12. lineLayer.removeAll()

移除所有线图层

1.3.13. lineLayer.destroy()

销毁本图层