JSAPI Three API Reference
    正在准备搜索索引...

    类 EngineMap

    地图管理器
    该类会随Engine的初始化自动实例化,不需要开发者手动执行初始化调用,通过engine.map访问

    engine.map.setCenter(center);
    engine.map.setZoom(14);

    层级

    • unknown
      • EngineMap
    索引

    构造函数

    • 参数

      • engine: Engine

        引擎实例

      • options: {
            center: any;
            heading: number;
            pitch: number;
            projection: string;
            provider: TileProvder;
            range: number;
        } = {}

        参数选项,默认为空对象

        • center: any

          初始视野中心点,经纬度形式。

        • heading: number

          初始视野旋转角度,以正北向为起始,逆时针方向递增。单位为角度。

        • pitch: number

          初始视野俯仰角,俯视为0,平时地平线为90。单位为角度。

        • projection: string

          目标投影。默认为EPSG:3857,即Web墨卡托投影。 可选投影包括:

          • EPSG:4326:WGS84坐标系,经纬度形式。
          • EPSG:3857:Web墨卡托投影,单位为米。别名包括EPSG:900913
          • EPSG:4978:ECEF坐标系,单位为米。别名包括ECEFGLOBE
        • provider: TileProvder

          初始状态的底图Provider,该Provider决定初始化时显示什么样的地图。当不设置时,默认初始化百度矢量地图。 初始化时,引擎默认根据provider自动创建一层底图,当需要进行复杂设置(如加载地形、实现多底图层叠等)时,可设置为null禁用初始化行为,通过MapView稍后设置。

        • range: number

          初始视野相机相对屏幕中心点对应的地面坐标的距离。单位为米。

      返回 EngineMap

    方法

    • 禁用地图控制

      返回 void

    • 销毁地图实例,移除其绑定事件

      返回 void

    • 开启地图控制,允许用户拖动、平移、旋转等操作

      返回 void

    • 获取地图当前可视范围边界坐标,返回Box3对象,坐标为投影坐标格式

      返回 Box3

    • 获取地图当前相机位置,经纬度坐标和高度

      参数

      • target: Object3D

      返回 Vector3

    • 获取地图当前中心点

      返回 number[]

    • 获取地图当前旋转角度

      返回 number

    • 获取地图当前倾斜角度

      返回 number

    • 获取地图当前中心点的投影坐标

      返回 number[]

    • 获取地图当前视线方向距离地面的距离

      返回 number

    • 获取地图当前容器的长度和宽度

      返回 Vector2

    • 获取地图当前视图高度

      返回 number

    • 设置地图视野

      参数

      • target: any

        目标视野中心点

      • offset: { heading: number; pitch: number; range: number } = {}

        视野角度,包括 heading、pitch,其中3d支持range、2d支持zoom

        • heading: number

          视野旋转角度,以正北向为起始,逆时针方向递增。单位为角度。

        • pitch: number

          视野俯仰角,俯视为0,平时地平线为90。单位为角度。

        • range: number

          视野距离地面的距离。单位为米。

      返回 void

    • 按照当前投影方式,将输入坐标转为投影坐标

      参数

      • input: number[]

        输入坐标

      • output: number[]

        输出坐标

      返回 number[]

    • 转换坐标数组

      参数

      • coordinates: any

      返回 number[]

    • 将地理坐标转换为投影坐标

      参数

      • input: Vector3
      • output: Vector3

      返回 Vector3

    • 设置地图可拖动视野区域

      参数

      • bounds: any[]

        区域的坐标,左下、右上的做标数组[sw, ne]

      返回 void

    • 设置地图中心点

      参数

      • center: number[]

        中心点坐标

      返回 void

    • 设置地图选转角度

      参数

      • heading: number

        选转角度

      返回 void

    • 设置3d地图最远视距

      参数

      • range: number

        距离

      返回 void

    • 设置地图倾斜角度

      参数

      • pitch: number

        倾斜角度

      返回 void

    • 设置地图视野距离地面的距离

      参数

      • range: number

        距离

      返回 void

    • 根据传入的坐标数组,设置地图视野

      参数

      • points: any[]

        坐标数组

      • options: { range: number } = ...

        偏移参数

        • range: number

          视野距离地面的距离。单位为米。

      返回 void

    • 设置地图缩放级别

      参数

      • zoom: number

        缩放级别

      返回 void

    • 按照当前投影方式,将输入坐标转为地理坐标

      参数

      • input: number[]
      • output: number[]

      返回 number[]

    • 将投影坐标转换为地理坐标

      参数

      • input: Vector3
      • output: Vector3

      返回 Vector3

    • 视野推进放大

      返回 void

    • 视野拉远缩小

      返回 void

    • 将地图缩放至object范围

      参数

      • object: Object3D
      • options: { range: number } = ...
        • range: number

          视野距离地面的距离。单位为米。

      返回 void

    访问器

    • get container(): any

      获取map的dom容器

      返回 any

    • get far(): any

      获取地图远裁面距离

      返回 any

    • get fov(): any

      获取地图视野开角

      返回 any

    • get mapView(): any

      获取初始化时创建的默认地图视图

      返回 any

    • get near(): any

      获取地图近裁面距离

      返回 any

    • get projection(): any

      获取投影方式

      返回 any