1. RoutePlan

室内外路径规划

1.1. new RoutePlan(geomap,options)

使用前的准备工作:
1.模型上传BOS应用，转为GIS模型（3DTiles）;
2.解析模型并获取URL加载至地球;
3.通过BOS3D接口对模型进行路网提取(http://prod-api.boswinner.com/bos3d_java_api/BOS3D/service/3D/navigation/moduleRoad.html );
4.在模型上选择n（0< n < 4）个标志点，获取标志点在3D场景中的坐标值（bim坐标）及在Gis场景（地球）中的cartesian3坐标值，并对应保存，用作bim坐标转gis坐标的使用；
5.录入模型的信息:模型相关信息组成的数组，数组的元素包含门的bim坐标，geoModelKey

Example

var geomap = new BOSGeo.GeoMap('bosgeoContainer');
var layerManager = geomap.layerManager;
var modelLayer = layerManager.createLayer(BOSGeo.LayerType.MODEL, '模型图层');

let testModel1 = modelLayer.add({
    name: 'testModel',
    // 江湖别墅,shp文件夹下
    url: 'http://bos3d.bimwinner.com/api/j798920c67de49e4aeb3634e52a84548/geomodels/G1622167164209/data/tileset.json',
    featureType: BOSGeo.FeatureType.BIM,
    position: [116.39714, 39.90960456049752, 4],
});

// 计算转换平移矩阵的对应点参数
var gisPoints = [], bimPoints = [];
// model1的坐标转换计算
gisPoints[0] = new BOSGeo.Cartesian3(-2178122.7986245733, 4388346.459914603, 4070290.527953177); //第一个gis坐标系取点
bimPoints[0] = {x: -4735.828424956734, y: -11685.68282250971, z: 6907.953764009171}; //第一个bim坐标系取对应点

var paramPoints = {
    gisPoints,
    bimPoints
};

//前期需要录入的信息:模型相关信息的数组，包含门的bim坐标，geoModelKey,并且需要提前提取好路网
var modelInfo = {
    doorsInfo: [{
        bimPoint: {x: 71.34385967662251, y: -10069.156074885028, z: 0}
    }, {
        bimPoint: {x: -9321.217008705518, y: -8887, z: 6.242604241011122}
    }, {
        bimPoint: {x: -11062.458175394913, y: 2892.4141433990926, z: 0}
    }, {
        bimPoint: {x: -12362.094455112878, y: -3117.260016632363, z: 0}
    }],
    geoModelKey: 'G1622167164209'
}

let testModel2 = modelLayer.add({
    name: 'testModel2',
    // 江湖别墅
    url: 'http://bos3d.bimwinner.com/api/le52fbc690684bca831905685f06a95d/geomodels/G1623317872900/data/tileset.json',
    featureType: BOSGeo.FeatureType.BIM,
    position: [116.39714, 39.90915, 6],
    // rotation:[2.9,0,0]       //模型位置
});

//model2的坐标转换参数
var model2gisPoints = [], model2bimPoints = [];
model2gisPoints[0] = new BOSGeo.Cartesian3(-2178136.9049482755, 4388375.550473269, 4070252.1342939124);
model2bimPoints[0] = {x: -4735.828424956734, y: -11685.68282250971, z: 6907.953764009171};

var model2paramPoints = {
    gisPoints: model2gisPoints,
    bimPoints: model2bimPoints
}

//前期需要录入的信息:模型相关信息的数组，包含门的bim坐标，geoModelKey,并且需要提前提取好路网
var model2Info = {
    doorsInfo: [{
        bimPoint: {x: 71.34385967662251, y: -10069.156074885028, z: 0}
    }, {
        bimPoint: {x: -9321.217008705518, y: -8887, z: 6.242604241011122}
    }, {
        bimPoint: {x: -11062.458175394913, y: 2892.4141433990926, z: 0}
    }, {
        bimPoint: {x: -12362.094455112878, y: -3117.260016632363, z: 0}
    }],
    geoModelKey: 'G1623317872900'
}

var routePlan;
var rootTransform2, coordinateTransform2;
testModel2.readyPromise.then(() => {
    rootTransform2 = testModel2.root.transform;
    coordinateTransform2 = BOSGeo.GeoUtil.computeCoordinateTransform(rootTransform2, model2paramPoints);
    model2Info.coorTransform = coordinateTransform2;

    // 3dTiles的根节点transform
    var rootTransform, coordinateTransform;
    testModel1.readyPromise.then(() => {
        rootTransform = testModel1.root.transform;
        coordinateTransform = BOSGeo.GeoUtil.computeCoordinateTransform(rootTransform, paramPoints);
        modelInfo.coorTransform = coordinateTransform;

        routePlan = new BOSGeo.RoutePlan(geomap, {
            isAutoRequest: true,
            modelsInfo: [modelInfo, model2Info],
        });
    })
})

1.2. 属性

1.2.1. routePlan.routeInfo

路径规划的路径信息结果

1.3. 方法

1.3.1. routePlan.requestRoute([options], [callback])

发送路径规划请求

Kind : instance method of RoutePlan

Example

routePlan = new BOSGeo.RoutePlan(geomap, {
    isAutoRequest: true,
    modelsInfo: [modelInfo1, modelInfo2, modelInfo3],
});
routePlan.requestRoute({
    startLocation: [116.39721664, 39.90955718, 6.29],
    endLocation: [116.39721152, 39.9091031, 6.46],
    startModel: testModel1,
    endModel: testModel2,
}, (data) => {
    console.log('data:', data)
});

1.3.2. routePlan.clear()

清除规划的路径信息

Example

var routePlan = new BOSGeo.RoutePlan(geomap, {
    isAutoRequest: false,
    startModel: modelInfo,
    endModel: model2Info
});
// 选点生成坐标路径后
routePlan.clear();

1.3.3. routePlan.startRoam(playSpeed, distanceThreshold)

开始漫游,根据解析渲染后的路径漫游

Example

var routePlan = new BOSGeo.RoutePlan(geomap, {
    isAutoRequest: false,
    startModel: modelInfo,
    endModel: model2Info
});
// 选点生成坐标路径后
routePlan.startRoam();

1.3.4. routePlan.stopRoam()

停止漫游

Example

var routePlan = new BOSGeo.RoutePlan(geomap, {
    isAutoRequest: false,
    startModel: modelInfo,
    endModel: model2Info
});
// 选点生成坐标路径后
routePlan.startRoam();
routePlan.stopRoam();

1.3.5. routePlan.pauseRoam()

暂停漫游

Example

var routePlan = new BOSGeo.RoutePlan(geomap, {
    isAutoRequest: false,
    startModel: modelInfo,
    endModel: model2Info
});
// 选点生成坐标路径后
routePlan.startRoam();
routePlan.pauseRoam();

1.3.6. routePlan.continueRoam()

继续漫游

Example

var routePlan = new BOSGeo.RoutePlan(geomap, {
    isAutoRequest: false,
    startModel: modelInfo,
    endModel: model2Info
});
// 选点生成坐标路径后
routePlan.startRoam();
routePlan.pauseRoam();
routePlan.continueRoam();

1.3.7. routePlan.addRightClickEventListener()

绑定地图事件的右键监听，弹出选起点终点提示面板

Kind : instance method of RoutePlan

1.3.8. routePlan.removeRightClickEventListener()

取消地图事件的右键监听