百度地图 JavaScript GL 版 v3.0, 新项目请使用 JSAPI 4.0
地理围栏 | 鹰眼轨迹服务 | 百度地图开放平台文档中心
地图
百度地图 JSAPI 最新 4.0 版本,底层为统一 WebGL 引擎,单个地图实例同时支持平面 2D 地图和带立体建筑的 3D 倾斜视图
概述 | JSAPI 4.0 | 百度地图开放平台文档中心:渲染方式由栅格图升级为WebGL渲染
全景图 | JSAPI GL | 百度地图开放平台文档中心
| 对比项 | BMapGL v1.0(WebGL 3D) | BMap v4.0(传统 2D) |
|---|---|---|
| 渲染引擎 | WebGL GPU 硬件加速,支持 3D 倾斜、建筑拔高、立体地形 | Canvas 2D 软渲染,纯平面地图,无立体 3D 效果 |
| 全局类名 | BMapGL.Map、BMapGL.Marker | BMap.Map、BMap.Marker,两套 API 完全不互通 |
| 版本定位 | 新一代 3D 地图引擎,主推现代化可视化、大数据图层 | 老旧 2D 引擎,仅维护兼容存量老项目,官方不再主推 |
| 性能表现 | 海量点、热力图、轨迹、矢量图层性能更强,大数据不卡顿 | 大量覆盖物时页面卡顿,渲染上限低 |
| 特色功能 | 3D 楼宇挤出、地形起伏、矢量地图、地图动画、倾斜旋转视角 | 仅基础 2D 标注、路线、弹窗,无立体可视化 |
| 移动端适配 | 移动端支持 3D,但低端手机 GPU 易掉帧、发热 | 移动端轻量化,兼容性更好,无 3D 消耗 |
| 文件体积 | SDK 体积更大,自带 3D 渲染逻辑、矢量瓦片 | 体积更小,加载更快,仅 2D 基础能力 |
| 迁移成本 | API 命名体系全新,老 BMap 代码不能直接复用 | 2.x/3.x 老项目无缝升级,方法名基本一致 |
| 推荐场景 | 大屏可视化、园区 / 城市 3D 展示、轨迹监控、热力聚合、GIS 分析 | 简单商家点位、静态展示、老旧项目兼容、低配设备页面 |
| 附加参数 | 支持callback回调、t时间戳防缓存 | 仅基础 ak,无内置 3D 样式 CSS |
提供地图展示、地点检索、路线规划、定位、覆盖物、地图可视化等丰富能力,可广泛应用于出行、物流、本地生活、数据可视化等多种业务场景。
基础概念
百度地图 JSAPI,
控件
地图添加缩放控件ZoomControl
地图类型切换控件MapTypeControl允许用户在普通地图和卫星混合模式之间切换
覆盖物Overlay
叠加在地图底图之上的可交互元素,map.addOverlay(overlay)跟随地图平移和缩放,是在地图上展示业务数据的主要方式
点标记BMap.Maker,文本标注Lable,圆形Circle,折线Polyline,多边形Polygon,信息窗口InfoWindow等
图层(Layer)
覆盖在底图之上的整体数据层。与覆盖物不同,图层通常是成片的数据渲染(如路况、卫星图、热力图、瓦片图),由渲染引擎统一绘制,性能优于逐个添加覆盖物。
瓦片(Tile)
地图底图被切分成的小正方形图片(通常 256×256 像素)。地图显示时根据当前视野和层级加载对应的瓦片拼接成完整画面。瓦片通过层级 + 行列号(z/x/y)索引。
IP定位
普通IP定位&IPv6定位
适用于对定位精度要求不高的IP请求定位的应用,IP 定位只精确到城市,zoom建议10~12,不要直接设 15
https://api.map.baidu.com/location/ip?ip=111.206.214.37&coor=bd09ll&ak=您的AK