AI 地图
产品服务
解决方案
文档与支持
定价
更新时间: 2026/07/27 10:37
您当前查看的是 JSAPI GL 历史版本文档。该版本仅用于维护现有项目,不建议用于新项目开发。新项目请使用 JSAPI 4.0,如需升级现有项目,请参考升级指南
You are viewing the legacy JSAPI GL documentation. This version is maintained for existing projects only and is not recommended for new development. For new projects, use the JSAPI 4.0 documentation. If you are upgrading an existing project, please refer to the Migration Guide.
JavaScript API GL 更新日志
2025.07.23
  • XYZLayer最大支持22级

  • 个性化地图V3版本上线,支持室内图配置

  • ViewAnimation添加renderCallback参数

2025.07.11
  • 修复区域个性化失效问题

2025.07.07
  • MapMask支持MultiPolygon

  • 修复轨迹插件安卓机绘制问题

2025.06.30
  • 轨迹插件支持隐藏行驶过的轨迹

2025.06.24
  • 个性化地图支持配置版本,默认V2

  • LocalSearch增加返回 areaname参数

2025.06.13
  • 增加enableAdaptiveMinZoom参数,支持关闭minZoom限制

2025.06.06
  • 修复LineLayer数据过大纹理不生效问题

2025.06.03
  • 修复CustomOverlay不受map.clearOverlays清除问题

  • 修复Label出视图边界消失问题

  • 地图点击事件添加overlay参数,可以区分是否点击到了overlay

2025.05.26
  • 优化overlay重复更新样式性能问题

2025.05.07
  • 修复MVTLayer数据量过大绘制错乱问题

2025.04.14
  • 修复Polygon.setPositionAt无效问题

2025.04.09
  • 修复disableDragging后不触发 mousemove问题

  • 修复map.getDistance返回NaN

  • setViewport支持gcj02坐标系

2025.01.09
  • LineLayerFillLayer图层支持高度设置,通过构造函数的参数options.isFlat: boolean设置为falseoptions.style.height: number | StyleExpress可进行高度配置

  • 实时路况图层支持动态刷新数据

  • 修复地球模式下,自定义覆盖物移动到地球背面后自动隐藏

  • 修复路线规划获取不到轨迹点问题

  • 修复超长Polyline覆盖物出现显示异常问题

2024.12.06
  • 全面支持全局GCJ02坐标系设置

  • 覆盖物线面覆盖物支持按层级相邻坐标距离抽稀

  • 修复InfoWindow事件在触摸屏PC端冒泡失效问题

2024.11.27
  • 修复GroundOverlay高频交互出现野数据问题

  • 修复设置地图旋转角时,出现绕大圈问题

  • 修复CustomOverlay事件在触摸屏PC端冒泡失效问题

  • 修复线图层间隔纹理存在毛刺问题

2024.10.12
  • ThreeLayer增加事件方法

  • MarkerCustomOverlay增加是否跟随地图旋转

  • MVTLayer支持多洞图形

2024.09.10
  • 支持多关键字圆形检索

  • 修复cookie字段名称导致部分用户防火墙拦截问题

  • LineLayer支持通过设置每个线节点生成最终渐变线

  • LineLayer支持通过线长度与渐变纹理生成渐变线

  • 地图增加扩展加载瓦片数量

  • 修复地图移动过程中Marker抖动问题

  • mouse事件增加是否来源于地图操作

  • 解决XYZLayer在透视投影和正交投影下高度异常问题

2024.08.30
  • XYZLayer支持高度和透明度配置

  • 地图支持正交投影模式

  • 修复地球模式跨180经线附近渲染异常出现黑块问题

  • 地铁图接口更新

  • 修复点图层点击事件失效问题

  • 修复GroundOverlay切换图像后移除视野再移入不显示问题

2024.07.18
  • 优化水印样式效果

  • 检索输入提示框支持显示隐藏配置

  • 修复同时使用多个城市控件只生效一个的问题,优化城市列表样式

  • 修复货车路线规划失败回调不触发问题

  • 修复地图destroy引起的控制台异常报错问题

2024.05.16
  • 端上手势适配,解决滚动页面内地图手势位置偏移问题

  • XYZLayer增加zTemplate可返回null从而不加载当前瓦片数据,可解决多层复用,从而降低内存占用

  • MVTLayer适配XYZLayer新特性,实现多层复用,降低内存占用

  • CustomOverlay增加zIndex设置、anchor锚点设置、显隐控制以及是否启用解决div自适应宽度

  • CustomHtmlLayer适配CustomOverlay新特性,并增加是否增量式更新数据模式、更新样式设置、清空图层数据等方法

  • FeatureLayer增加清空图层渲染数据方法

  • FillLayer减少uniform数量

  • PointIconLayer实现anchor锚点位置表达式设置以及图标尺寸表达式设置

  • Earth模式下webgl背景色可设置透明

  • Earth模式下可锁轴进行移动地图

  • 驾车路线规划支持新策略

  • 修复大层级下行政区划边界线显示不完全问题

2024.04.22
  • MVTLayer增加cacheSize参数配置,控制缓存瓦片数量大小

  • indoor:false增加不显示默认室内图图层的POI

  • 解决点图层在android设备上不显示问题

  • 解决使用淹膜图层时调用销毁函数触发地图重绘

  • 解决特定场景下(瓦片多=>POI量大)地图重复重绘,开发者可通过配置Map参数textureSizeHeight控制大小

  • 解决跨180度经线调用getViewport()返回Center经度不正确

  • 解决调用JSAPI的路线规划设置18个途经点后报错

  • 解决自定义覆盖物调用hide方法隐藏之后移动地图显示的问题

  • 解决调用地点检索出现的内存泄漏问题

2024.03.21
  • 解决覆盖物面填充图形与描边图形不对齐问题

  • 解决线图层线节点超过65536渲染异常问题

  • 解决NormalLayer鼠标事件会改变地图背景色问题

2024.03.01
  • 驾车路线规划渲染支持用户配置

  • 线面覆盖物采用一体化渲染,解决面描边与面层级不一致问题

  • 修复线面覆盖物地图倾斜状态下事件失效问题

  • 自定覆盖物增加显示隐藏能力,并修复自定覆盖物图层的显示隐藏

2024.01.10

新增功能:

  • Map对象提供mouseoutmouseup事件

  • 地图着色支持可动态设置,详见示例

  • 挖洞面覆盖物支持绘制与编辑操作,详见绘制示例编辑示例

  • 通过初始化options 参数{isTop?:boolean}或者XYZLayer类方法setTop(isTop?:boolean)设置XYZLayer图层是否显示在线面覆盖物上面,默认false,显示在线面覆盖物下面

  • 通过初始化options 参数{enableParse?:boolean}设置线面覆盖物是否抽稀,默认true,进行抽稀

稳定性优化:

  • 修复线面覆盖物初始化zIndex设置失效问题

2023.11.30

稳定性优化:

  • 修复0度经度附近进行缩放,会出现漂移问题

  • 修复 CustomOverlay移动端上click事件会触发地图Map的click事件问题

2023.11.02

新增功能:

  • 个性化地图面要素支持纹理填充、支持图片纹理类要素改变颜色

  • 支持道路车道线相关要素显示

  • 支持地图区域统一着色

  • 新增ThreeLayer图层,可结合Threejs库进行三维可视化开发

  • 楼块默认侧面单色显示,Map设置option.displayOptions?.buildingSideGradation:boolean可开启是否采用渐变显示

稳定性优化:

  • 修复移除交通流图层时地图刷新问题

  • 解决 NormalLayer由于Map容器视图尺寸变化,导致的事件失效问题

  • 解决大于19级比例尺显示undefined问题以及地图在小比例尺时两级区域显示比例尺过长问题

2023.10.09

新增功能:

  • 卫星图像以及路网支持正负180度连续显示

稳定性优化:

  • 修复底图自定义POI在卫星图模式下不展示问题

  • 修复增删底图自定义POI引起的碰撞异常问题,以及设置大量相同图标的POI偶现图片不显示问题

2023.09.15

新增功能:

  • 通过设置Map对象的options 参数 {overlayTop?:boolean}控制覆盖物是否在文字上面显示

  • 地球模式支持新配置,通过设置Map对象的options 参数{
    earthMinZoom?: number, // 最小缩放级别,另外可以通过setEarthMinZoom方法设置
    earthMaxZoom?: number,// 另外可以通过setEarthMaxZoom方法设置
    earthSun?: boolean, // 控制太阳显示
    earthClouds?: boolean, // 控制大气显示
    earthMarkerShowAllTime?: boolean,// 控制点覆盖物是否在小级别展示
    earthUseRound?: boolean // 设置false,可解决地球旋转时标记点抖动问题
    }

稳定性优化:

  • 修复城市检索控件部分城市地图定位失效问题

  • 修复覆盖物BMapGL.SVGSymbol图标相同时,不能分别设置图标样式问题

2023.08.11

新增功能:

稳定性优化:

  • 修复XYZLayer透明度图像颜色异常问题

  • 修复线覆盖物设置样式不生效问题

  • 地面覆盖物兼容JSAPI3.0BMapGL.Bounds对象

2023.07.21

新增功能:

稳定性优化:

  • 修复地图掩膜切换区域导致地图显示不正确问题

  • 修复地图背景色设置在个性化地图模式下失效问题

2023.07.13

新增功能:

  • 地址逆解析结果增加距离相关字段

稳定性优化:

  • 修复自定义覆盖物抖动问题

  • 解决FeatureLayer在大比例尺下数据发生抖动问题。可通过构造函数options增加参考中心点属性referCenter?:BMapGL.Point或者通过方法setRefCenter(point:BMapGL.Point)来解决。

  • 修改鼠标中键为平移地图操作

2023.07.06

新增功能:

稳定性优化:

  • 支撑海量自定义底图POI上图

2023.06.08

新增功能:

  • 线图层描边不被压盖配置,options的style配置增加borderCovered:boolean,默认true,会出现描边被线填充覆盖现象。如果设置false,则不会出现压盖现象,但不允许使用图像纹理模式

  • Map的setMaxZoom方法支持最大25级的地图等级设置

  • BMapGL.InfoWindow的options 添加 canScroll:boolean配置,默认false,鼠标在InfoWindow的滑动会触发地图事件。如果设置为true,则滑动不会触发地图事件。

稳定性优化:

  • 修复地图缩放后,地图比例尺数值错误的问题

2023.05.29

新增功能:

  • 新增货车路线规划类 BMapGL.TruckRoute,详见文档

  • 新增支持蚯蚓线和拖动的驾车路线规划类 BMapGL.DrivingRouteLine,详见文档

  • BMapGL.GroundOverlay通过使用方法 setImage(url:string,bounds?:BMapGL.Bounds)支持图像源更新,可以附加四至范围同步更新

  • BMapGL.GroundOverlay支持fixed模式,详见示例

2023.05.19

新增功能:

  • BMapGL.LineLayer支持蚯蚓线、痕迹设色或者不显示设置,详见示例

  • BMapGL.TileLayer基类图层支持开始加载&结束加载瓦片事件,继承类 BMapGL.XYZLayerBMapGL.MVTLayer同样支持,使用方法如下:
    tLayer.on('ontilesloadstart', () => console.log('vecLayer start load Tile'));
    tLayer.on('ontilesloadend', () => console.log('vecLayer finish load Tile'));

稳定性优化:

  • 修复 BMapGL.TileLayer基类初始化zIndex失效问题

  • 修复 ZoomControl控件隐藏失效问题

2023.04.20

新增功能:

  • 卫星底图通过配置BMapGL.Mapoptions.showVectorStreetLayer:true设置是否加载POI和options.showVectorLine:true设置是否加载路网数据,需要注意的是路网数据的加载依赖必需加载POI。

  • BMapGL.Marker3D的options.icon支持BMapGL.Symbol数据源,支持动态纹理设置。

2023.03.23

新增功能:

  • 新增支持空底图切换,初始化设置 var map = new BMapGL.Map('container',{mapType:BMAP_NONE_MAP}) 或 map.setMapType(BMAP_NONE_MAP) 。

  • BMapGL.XYZLayer支持内外两种掩膜方式,构造函数options增加showRegion: 'inside'|'outside'

2023.02.24

新增功能:

  • Map新增enableRotateGestures()disableRotateGestures()方法。

稳定性优化:

  • 修复定位控件在http模式下失效问题

  • 定位控件增加事件监听

  • 优化更改中心点地图无倾斜角问题

  • 修复禁止双指缩放的方法未生效问题

2023.02.20

新增功能:

2023.02.06

新增功能:

  • 地面覆盖物BMapGL.GroundOverlay支持设置透明度&四至范围

稳定性优化:

  • 手机端H5页面点覆盖物启用拖动模式下,修复手势不能拖动问题

  • 修复内存泄漏

2023.01.05

新增功能:

  • 新增线图层,在支持实线、虚线的基础上支持描边线、纹理贴图线、间隔图标填充,可组合实现多种可视化效果。

  • 新增面图层,在支持面颜色填充、描边基础上,支持纹理填充。

  • 支持用户主动触发地图点击动画效果。首先,注册onhotclick事件,示例:let hotevent = new BMapGL.Event('onhotclick');然后,设置pixel属性值为鼠标点击像素位置,可以使用地图事件e,取其中的像素坐标,示例:hotevent.pixel = new BMapGL.Pixel(e.pixel.x, e.pixel.y)或者hotevent.pixel = map.pointToPixel(e.latlng);最后,触发Map事件,示例:map.dispatchEvent(hotevent)

稳定性优化:

  • BMapGL.Polyline支持通过设置linkRight:trueclip:false,解决跨±180度经线绘制问题。

2022.12.19

新增功能:

  • 覆盖物支持添加ContextMenu对象。

  • MVTLayer支持用户设置请求瓦片的header头文件。

  • MVTLayer在不指定图层名时,默认:线数据渲染在面上面,可以通过defaultOrder:false设置,将面渲染在线上。

2022.12.08

新增功能:

  • MVTLayer支持缩放过程中平滑过渡。

  • MVTLayer支持添加额外自定义文字。

稳定性优化:

  • centerAndZoom支持以省份全称定位。

  • 修复自定义文字缺陷。

  • 修复线编辑状态下设置坐标串,未重置编辑节点。

  • 修复因底图样式找不到造成的数据不解析问题。

2022.11.25

新增功能:

  • mvt支持加解密请求

2022.11.17

新增功能:

  • MVTLayer支持加密数据请求。

稳定性优化:

  • 修复safari浏览器加载矢量瓦片问题。

  • 修复MVTLayer空间数据运算。

  • 修复跨层级路线文字展示问题。

2022.11.08

新增功能:

  • 支持MVTLayer图层功能。

  • XYZLayer支持png8图像设置。

  • 底图添加自定义poi点支持图标&背景图设置。

稳定性优化:

  • 修复Marker阻挡Map右键事件。

  • 修复个性化底图与卫星图底图切换过程中,导致文字纹理错误问题。

2022.10.13

新增功能:

  • Marker支持添加svg路径图标,参考示例

  • Marker通过Symbol支持动态纹理设置,参考示例

  • GroundOverlay在Canvas模式下支持动态纹理设置,参考示例

  • 新增圆覆盖物的toGeoJSON方法,转polygon。

稳定性优化:

  • 修复marker右键事件不冒泡问题。

  • 修复圆在绘制过程控制台报错。

2022.09.18

新增功能:

  • 线、面、圆覆盖物鼠标悬浮图标配置

  • 点、线、面覆盖物添加geojson转换以及geojson更新数据。

  • 线、面、圆编辑节点可配置图标。

  • 线、面、圆边可设置图片纹理。

稳定性优化:

  • JSAPI定位逻辑优化。

2022.08.23

新增功能:

  • 新增GeoJSONParse类,满足用户将GeoJSON数据解析为符合百度地图坐标的Overlay数据。

  • 新增GeoJSONLayer类,满足用户将GeoJSON数据直接解析为覆盖物的GeoJSON图层

2022.08.07

新增功能:

2022.06.08

新增功能:

2022.06.06

新增功能:

2022.03.12

新增功能:

  • 新增DistrictLayer图层,支持以JSAPI方式获取的新版行政区划数据,并进行行政区划图层展示。

  • 新增行政区合并为大区的特色功能。

2021.11.22

新增功能:

  • 新增XYZLayer类支持加载EPSG3857坐标系统的WMS图层、WMTS图层、TMS图层、以及自定义栅格图层。

2021.08.29

新增功能:

  • 支持卫星图切换。

稳定性优化:

  • 优化内部稳定性,修复部分bug。

2019.11.01

新增功能:

  • 采用WebGL渲染底图,支持3D视角,旋转。

  • 支持比例尺、缩放基本控件。

  • 支持点、线、多边形和圆形覆盖物绘制。

上一篇

示例DEMO

下一篇

常见问题
本篇文章对您是否有帮助?