Class MapController

地图实例

Abstract

提供地图的交互控制与地图要素控制

Since

1.0.0

Package

@bdmap/map

Properties

`Readonly` mapViewId

mapViewId: string

地图唯一标识

`Readonly` filesDir

filesDir: string

沙盒文件目录

`Readonly` cacheDir

cacheDir: string

沙盒缓存目录

`Readonly` densityDPI

densityDPI: number

设备的像素密度

`Readonly` dpiScale

dpiScale: number

适配比例

Accessors

mapOptions

get mapOptions(): MapOptions
获取地图配置类

Returns MapOptions
Since
1.0.0
set mapOptions(mapOptions): void
设置地图配置类
Parameters
- mapOptions: MapOptions
Returns void
Since
1.0.0

mapStatus

get mapStatus(): MapStatus
获取地图显示状态类

Returns MapStatus
Since
1.0.0
set mapStatus(mapStatus): void
设置地图显示状态类
Parameters
- mapStatus: MapStatus
Returns void
Since
1.0.0

maxZoom

get maxZoom(): number
获取当前地图最大缩放级别

Returns number
Since
1.0.0
set maxZoom(zoom): void
设置地图最大缩放级别
Parameters
- zoom: number
Returns void
Since
1.0.0

minZoom

get minZoom(): number
获取地图最小缩放级别

Returns number
Since
1.0.0
set minZoom(zoom): void
设置地图最小缩放级别
Parameters
- zoom: number
  最小级别，范围3-21
Returns void
Since
1.0.0

Methods

addEventListener

addEventListener(model, fun): void
注册地图事件
Parameters
- model: MapEvent
  地图事件名称
- fun: Callback<TMapViewEvent>
  回调响应函数
Returns void
Since
1.0.0

removeEventListener

removeEventListener(model, fun): void
移除地图事件
Parameters
- model: MapEvent
  地图事件名称
- fun: Callback<TMapViewEvent>
  回调响应函数
Returns void
Since
1.0.0

addOverlay

addOverlay(overlay): void
添加地图覆盖物
Parameters
- overlay: Overlay | default
  覆盖物对象
Returns void
Since
1.0.0

removeOverlay

removeOverlay(overlay): void
移除地图覆盖物
Parameters
- overlay: Overlay | default
  覆盖物对象
Returns void
Since
1.0.0

setViewport

setViewport(points, options?): void
根据地理坐标设置地图最佳视野
Parameters
- points: LatLng[]
  坐标序列点
- Optional options: IViewportOption
  可选配置
Returns void
Since
1.1.0

getViewport

getViewport(points, options?): {
    center: Point | LatLng;
    ptOffset: Point;
    zoom: number;
}
根据地理坐标获取地图最佳视野
Parameters
- points: Bounds | LatLng[]
  坐标序列点
- Optional options: IViewportOption
  可选配置
Returns {
    center: Point | LatLng;
    ptOffset: Point;
    zoom: number;
}
表示地图的中心点，偏移量和级别
- center: Point | LatLng
- ptOffset: Point
- zoom: number
Since
1.1.0

fitVisibleMapRect

fitVisibleMapRect(bounds, insets, withAnimated): void
据当前mapView的窗口大小，预留insets指定的边界区域后，将mapRect指定的地理范围显示在剩余的区域内，并尽量充满
Parameters
- bounds: Bounds
  要显示的地图范围
- insets: WinRound
  屏幕四周预留的边界大小
- withAnimated: boolean
Returns void
Since
1.1.0

setViewPadding

setViewPadding(left, right, top, bottom): void
设置地图操作区距控件的距离
Parameters
- left: number
- right: number
- top: number
- bottom: number
Returns void
Since
1.2.0

setGeoRoundLimit

setGeoRoundLimit(bounds): void
设置地图操作区地理显示范围
Parameters
- bounds: Bounds
Returns void
Since
1.2.0

getZoomUnits

getZoomUnits(zoom): number
根据级别获取1像素对应的MC单位
Parameters
- zoom: Nullable<number>
  级别
Returns number

removeOverlays

removeOverlays(type?): void
按类别移除地图覆盖物
Parameters
- Optional type: OverlayType
  覆盖物类型
Returns void
Since
1.0.2

getLayerByTag

getLayerByTag(tag): Nullable<TLayer>
获取图层实例对象
Parameters
- tag: LayerTag
  图层标记
Returns Nullable<TLayer>

setLocation

setLocation(opts): void
更新定位图层设置
Parameters
- opts: ILocation
Returns void
Since
1.0.0

addTileLayer

addTileLayer(layer): void
添加瓦片图层
Parameters
- layer: TileLayer
Returns void
Since
1.2.0

removeTileLayer

removeTileLayer(layer): void
移除瓦片图层
Parameters
- layer: TileLayer
Returns void
Since
1.2.0

setMaxZoom

setMaxZoom(zoom): void
设置地图最大缩放级别
Parameters
- zoom: number
  最大级别，范围3-21
Returns void
Since
1.0.0

setMinZoom

setMinZoom(zoom): void
设置地图最小缩放级别
Parameters
- zoom: number
  最小级别，范围3-21
Returns void
Since
1.0.0

zoomTo

zoomTo(level?, center, screenOffset): any
更新地图到指定等级
Parameters
- level: number = 3
  地图等级，默认为3
- center: Nullable<LatLng>
  地图缩放位置地理坐标，可选
- screenOffset: Nullable<[number, number]>
  地图缩放位置像素坐标，可选
Returns any
Since
1.0.0

zoomInOne

zoomInOne(center?, screenOffset?): any
放大地图一级
Parameters
- Optional center: Nullable<LatLng>
  放大中心点，可选
- Optional screenOffset: Nullable<[number, number]>
  地图缩放位置像素坐标，可选
Returns any
Since
1.0.0

zoomOutOne

zoomOutOne(center?, screenOffset?): any
缩小地图一级
Parameters
- Optional center: Nullable<LatLng>
  缩小中心点
- Optional screenOffset: Nullable<[number, number]>
  地图缩放位置像素坐标
Returns any
Since
1.0.0

getZoom

getZoom(): number
获取当前地图等级

Returns number
Since
1.0.0

setMapCenter

setMapCenter(center, zoom, isAnimate?, animationTime?): void
根据经纬度设置并更新地图中心点
Parameters
- center: ISetCenter
  移动到新的地图窗口中心点位置
- zoom: Nullable<number>
  缩放等级
- isAnimate: boolean = true
  是否启用动画过度
- animationTime: number = 300
  动画时间
Returns void
Since
1.0.0

setMapCenterWithOffset

setMapCenterWithOffset(center, offset, zoom, isAnimate?, animationTime?): void
根据经纬度设置并更新地图中心点
Parameters
- center: ISetCenter
  移动到新的地图窗口中心点位置
- offset: Point
  偏移量，单位像素坐标
- zoom: Nullable<number>
  缩放等级
- isAnimate: boolean = true
  是否启用动画过度
- animationTime: number = 300
  动画时间
Returns void
Since
1.1.0

getCenter

getCenter(options?): Point | LatLng
获取地图中心点默认为经纬度坐标，若配置mercator参数为true则返回墨卡托坐标
Parameters
- Optional options: Nullable<IGetPoint>
Returns Point | LatLng
Since
1.0.0

getRotate

getRotate(): number
获取旋转角

Returns number
Since
1.0.0

getPerPixelMc

getPerPixelMc(): number
获取每像素代表多少墨卡托

Returns number
Since
1.0.0

enableGesturesRotate

enableGesturesRotate(): void
允许手势触发地图旋转

Returns void
Since
1.0.0

disableGesturesRotate

disableGesturesRotate(): void
不允许手势触发地图旋转

Returns void
Since
1.0.0

enableGesturesZoom

enableGesturesZoom(): void
允许手势触发地图缩放

Returns void
Since
1.0.0

disableGesturesZoom

disableGesturesZoom(): void
不允许手势触发地图缩放

Returns void
Since
1.0.0

enableGesturesDrag

enableGesturesDrag(): void
允许手势触发地图拖动

Returns void
Since
1.0.0

disableGesturesDrag

disableGesturesDrag(): void
不允许手势触发地图拖动

Returns void
Since
1.0.0

enableGesturesPich

enableGesturesPich(): void
允许手势触发地图倾斜

Returns void
Since
1.0.0

disableGesturesPich

disableGesturesPich(): void
不允许手势触发地图倾斜

Returns void
Since
1.0.0

switchIndoorFloor

switchIndoorFloor(floor, uid): void
设置显示楼层
Parameters
- floor: string
- uid: string
Returns void
Since
1.0.0

getIndoorInfo

getIndoorInfo(uid?): Nullable<IndoorFloorBundles>
获取建筑楼层数据
Parameters
- Optional uid: Nullable<string>
Returns Nullable<IndoorFloorBundles>
Since
1.0.0

initCustomStyle

initCustomStyle(r_path, callback, overwrite?): void
设置地图样式
Parameters
- r_path: string
  rawfile样式文件路径
- callback: Callback<void>
  回调函数
- overwrite: boolean = false
  是否覆盖已经存在的样式
Returns void
Since
1.0.0

setCustomStyleEnable

setCustomStyleEnable(enable): boolean
地图切换显示个性化样式
Parameters
- enable: boolean
Returns boolean
Since
1.0.0

pixel2bdll

pixel2bdll(left, top): Nullable<LatLng>
屏幕像素坐标转地理坐标
Parameters
- left: number
  像素坐标left
- top: number
  像素坐标top
Returns Nullable<LatLng>
Since
1.0.0

bdll2pixel

bdll2pixel(latlng): Nullable<[number, number]>
地理坐标转屏幕像素坐标
Parameters
- latlng: LatLng
Returns Nullable<[number, number]>
Since
1.0.0

onceDraw

onceDraw(): void
主动调用绘制一次

Returns void
Since
1.0.2

refresh

refresh(): void
Returns void

`Static` copyCfgToSandBox

copyCfgToSandBox(fcontext): void
Parameters
- fcontext: Context
Returns void

destroy

destroy(): void
Returns void