1. GeoMap

1.1. 初始化 new GeoMap(containerId, options)

BOSGeo（GeoViewer）三维引擎入口，用于创建三维地图引擎，是Viewer和LayerManager的父类。 其中，Viewer是用于构建应用程序的基础部件，它将所有标准的Cesium部件组合成一个可重复使用的包； LayerManager是图层管理类，用于图层分组，点、线、几何、模型、地形、影像、GeoJson、KML等类型图层的创建、获取和删除等操作。

Example

var geomap = new BOSGeo.GeoMap('bosgeoContainer', {
    baseMap: BOSGeo.ImageryMapType.BING_DARK, //底图类型
    globeCloud: false,    //云层效果
    requestRenderMode: true //是否实时渲染
});

1.2. 属性

1.3. 方法

1.3.1. geoMap.render()

渲染当前帧 如果requestRenderMode为true,则在场景发生改变的时候,需要调用该方法

Example

geomap.render(); // 手动调用渲染当前帧

1.3.2. geoMap.requestFullscreen()

全屏模式,去除所有功能按钮

1.3.3. geoMap.fullScreen()

全屏模式,保留功能界面

1.3.4. geoMap.zoomInOut(flag)

缩放

1.3.5. geoMap.exitFullscreen()

退出全屏

1.3.6. geoMap.restNorth()

恢复正北方向

1.3.7. geoMap.flyTo(dest, hpr, callback)

飞至指定位置

Example

//当前视角的dest和hpr可通过BOSGeo.GeoUtil.getCameraPositionOrientation2()接口获取
function completeCallback() {
    alert("您已到达目的地!")
}

geoViewer.flyTo(
    {x: -9439629.577977773, y: 35229177.18964299, z: 21138934.807071898},
    {heading: 6.283185307179586, pitch: -1.5687578423337296, roll: 0},
    completeCallback
);

1.3.8. geoMap.flyToBoundingSphere(position, distance)

通过包围盒范围飞至观察点上方

1.3.9. geoMap.flyHome([duration])

相机飞行到主视图

Example

geomap.flyHome(3);

1.3.10. geoMap.setView(dest, hpr)

设置相机视角

Example

var dest = BOSGeo.Cartesian3.fromDegrees(114, 22.5, 10000);
var hpr = {
    heading: BOSGeo.Math.toRadians(0),
    pitch: BOSGeo.Math.toRadians(-45),
    roll: BOSGeo.Math.toRadians(0),
};
geoViewer.setView(dest, hpr);

1.3.11. geoMap.flyToRectangle(cartesians, [heading], [pitch], [scale], [duration], [callBack])

飞行定位到一个矩形

1.3.12. geoMap.navigation(options) ⇒ Object

场景控制器，导航工具

Returns : Object -

返回包含罗盘DIV（compassDiv）、缩放控制DIV（navigationControlsDiv）、以及导航工具对象（geoNavigation），便于调整样式。

Example

var geomap = new BOSGeo.GeoMap('bosgeoContainer');
geomap.navigation({
    defaultResetView: [70, 12, 145, 60],  //默认视图范围
    enableCompass: true,                  //启用罗盘
    enableZoomControls: true,             //启用缩放控件
    enableCompassOuterRing: true           //启用指南针外环
})
var style = navigation.geoNavigation.container.style;  //导航工具样式
style.right = '70px'; //导航工具样式修改
style.top = '40px';

1.3.13. geoMap.getCameraPositionOrientation() ⇒ Object

获取当前相机的坐标和方位

Returns : Object -

posAndOri -返回相机三维笛卡尔坐标(position)和方位信息(orientation)

1.3.14. geoMap.on(eventType, callBack, wishResult)

地图事件监听

Example

var map = new BOSGeo.GeoMap('container');
map.on(BOSGeo.MapEventType.LEFT_CLICK, (e) => {
    console.log(e.world_position);
    console.log(e.feature);//获取到的原始数据
    if (e.feature) {
        //地图拾取的feature是模型的片段或矢量图标的片段，使用本函数获取到对应的模型和矢量元素。
        const target = BOSGeo.GeoUtil.getPickTargetFeature(e.feature).target;
    }
}, [BOSGeo.MapPickType.WORLD_POSITION, BOSGeo.MapPickType.FEATURE]);

1.3.15. geoMap.off(eventType, callBack)

取消地图事件的监听

Example

var map = new BOSGeo.GeoMap('container');
map.on(BOSGeo.MapEventType.LEFT_CLICK, (e) => {
    console.log(e.world_position);
    console.log(e.feature);//获取到的原始数据
    if (e.feature) {
        //地图拾取的feature是模型的片段或矢量图标的片段，使用本函数获取到对应的模型和矢量元素。
        const target = BOSGeo.GeoUtil.getPickTargetFeature(e.feature).target;
    }
}, [BOSGeo.MapPickType.WORLD_POSITION, BOSGeo.MapPickType.FEATURE]);
setTimeout(()=>{    
    map.off(BOSGeo.MapEventType.LEFT_CLICK);
},3000)

1.3.16. geoMap.once(eventType, callBack, wishResult)

一次性地图事件监听

Example

var map = new BOSGeo.GeoMap('container');
map.once(BOSGeo.MapEventType.LEFT_CLICK, (result) => {
    console.log(result);
}, [BOSGeo.MapPickType.WORLD_POSITION, BOSGeo.MapPickType.FEATURE]);

1.3.17. geoMap.enableMoveFeature(axisFrame, callback)

启用要素按坐标轴拖拽移动功能

Example

//创建模型图层 modelLayer
//添加模型model
const axis = new BOSGeo.AxisFrame({target: model});
geomap.enableMoveFeature(axis, (result) => console.log('每次移动变化监听：' + result.currentPosition));

1.3.18. geoMap.disableMoveFeature()

关闭要素移动功能。移除AxisFrame和GeoMap绑定的点击移动事件。

1.3.19. geoMap.show3DCoordinates(options)

在地图底部显示相机方位和鼠标位置信息(实时获取ArcGIS地形的高程信息性能较差，如有需要建议使用其他地形数据)

Example

geomap.show3DCoordinates();

1.3.20. geoMap.remove3DCoordinates()

移除地图底部显示的相机方位和鼠标位置信息

Example

geomap.remove3DCoordinates();

1.3.21. geoMap.setClock(flag, [time])

设置日照时间

Example

geomap.setClock(true, '2021/03/31 12:00:00');

1.3.22. geoMap.setBaseMap(imageryMapType)

切换底图，支持底图类型有：天地图影像、天地图矢量（包含矢量注记）、高德影像、高德矢量、百度影像、百度矢量、Arcgis影像、谷歌影像、openstreet影像、openstreet矢量、MapBox影像、必应影像、必应矢量、必应暗黑风格底图

Kind : instance method of GeoMap

Example

var map = new BOSGeo.GeoMap('container');
map.setBaseMap(BOSGeo.ImageryMapType.TDT_IMAGERY);

1.3.23. geoMap.removeBaseMap()

移除底图

Example

var map = new BOSGeo.GeoMap('container');
map.removeBaseMap();

1.3.24. geoMap.destroy()

销毁