上手百度地图--开放平台必懂API使用场合(PC端)

本篇整理仅适用与没有接触或对百度地图开放平台API基本没有概念的人

拖拽类

• 启用地图拖拽 默认启用 enableDragging()
  对应的禁止方法 disableDragging( )
• 启用地图习惯性拖拽 默认禁止 enableInertialDragging()
  对应的禁止方法 disabInertialDragging
• 设置地图可拖动区域，参数为地图拖拽的区域范围 setBounds(bounds:Bounds)

缩放类

• 启用自动适应容器尺寸变化，默认启用 enableAutoResize()
• 禁用自动适应容器尺寸变化 disableAutoResize()
• 允许地图可被鼠标滚轮缩放，默认禁用 enableScrollWheelZoom()
  禁止地图被鼠标滚轮缩放 disableScrollWheelZoom()
• 开启双击平滑缩放效果 enableContinuousZoom()
  关闭双击平滑效果 disableContinuousZoom()
  • 启用地图双击缩放，左键双击放大，右键双击缩小enableResizeOnCenter()
    取消地图双击缩放 disableResizeOnCenter()

resize （）

强制地图调整尺寸，此时会以当前容器尺寸为基准重新计算视野所需图像数据并重新绘制。当关闭自动调整视野时（enableAutoResize 配置），需要调用此方法来强制地图刷新。

关于图区resize中心点

• 开启图区中心点位置不变 enableResizeOnCenter()
• 关闭图区中心位置不变 disableResizeOnCenter()

开启键盘

-启用键盘操作，默认禁用。 enableKeyboard()键盘的上、下、左、右键可连续移动地图。同时按下其中两个键可使地图进行对角移动。PgUp、PgDn、Home和End键会使地图平移其1/2的大小。+、-键会使地图放大或缩小一级

• 禁用 disableKeyboard()

地图相关属性

• 地图当前尺寸 （px）getsize() 返回size
• 地图容器的尺寸 getCountainerSize(),返回size
• 地图的DOM容器元素 getContainer() 返回HTMLElement
• 地图级别 getZoomUnits() 返回Number 一个像素对应多少单位的平面墨卡托坐标
• 地图类型 getMapType()
• 获取地图坐标类型，为CoordType常量 getMapStyleId()

坐标类

• 像素坐标转化为经纬度坐标 pixelToPoint(pixel:Pixel) 返回Point(点的坐标)
• 经纬度坐标转换为像素坐标 pointToPixel（point:Point）返回经纬度坐标
• 经纬度球体坐标转换为墨卡托平面坐标 lnglatToMercator(lng: Number, lat: Number)，返回墨卡托平面坐标
• 墨卡托平面坐标转换为经纬度球体坐标 mercatorToLnglat(McLng: Number, lat: McLat) 返回经纬度球体坐标
• 返回两点之间的距离，单位是米 getDistance(start: Point , end: Point )

关于在地图上区域的增删改查

• 添加地点区域，作为地图上的虚拟可点击区域。其中参数spots为热区点数组，options为可选配置参数；返回区域id。addSpots(spots: Array, options: Object)
• 初始化地图。 centerAndZoom(center: Point , zoom: Number)

1. 坐标类

• 根据id返回地点区域数组 getSpots(id: string)
• 根据id移除区域数组 removeSpots(id: number)
• 清除地点区域，此操作将清空所有虚拟可点数据 clearSpots()
• 清空当前map所有的自定义底图标注 clearLabels()
• 通过点击坐标获取当前点中的底图icon，如果获取到返回其{name, uid, position}，否则返回null getIconByClickPosition(clickPosition: Pixel)

2. 文字类

• 在底图上添加文字，这些文字会和底图文字一同参与避让。 addLabelsToMapTile(labels:Array)
• 从底图上移除文字标注，参数为uid数组，根据数组里的uid进行移除 removeLabelsFromMapTile(labelUids:Array)

3. 功能类

• 将地图的中心点更改为给定的点，跳转到指定中心点进行渲染 panTo(center: Point ) 相当于translate
• 重新设置地图，恢复地图初始化时的中心点和级别 相当于restore reset()
• 将地图在水平位置上移动x像素，垂直位置上移动y像素。如果指定的像素大于可视区域范围或者在配置中指定没有动画效果，则不执行滑动效果 panBy(x: Number, y: Number)
• 飞到指定的中心点和级别，提供给定位缩放地图使用 flyTo(center: Point , zoom: Number)
  -设置地图可拖动区域，参数为地图拖拽的区域范围 setBounds(bounds:Bounds)
• 获取地图当前视野范围的矩形区域，以地理坐标表示。如果地图尚未初始化则返回一个空的 Bounds 实例。 getBounds()