@baidumap/jsapi-v4-types

百度地图 JSAPI 4.0 TypeScript 类型声明，提供 BMap 命名空间下所有类、接口、常量的完整类型定义。

安装

npm install -D @baidumap/jsapi-v4-types

安装后即可在项目中获得 BMap 命名空间的完整类型提示，无需额外配置。

如果你的 tsconfig.json 中已显式配置了 compilerOptions.types，则需要将包名加入该数组：

{
  "compilerOptions": {
    "types": ["@baidumap/jsapi-v4-types"]
  }
}

引入地图 JSAPI

在 HTML 中通过 script 标签引入：

<script type="text/javascript" src="https://api.map.baidu.com/api?v=4.0&ak=你的密钥"></script>

引入后全局即可使用 BMap 命名空间。密钥申请地址：https://lbsyun.baidu.com/apiconsole/key

示例

// 初始化地图
const map = new BMap.Map('container');
map.centerAndZoom(new BMap.Point(116.404, 39.915), 12);
map.enableScrollWheelZoom();

// 添加面图层
const fillLayer = new BMap.FillLayer({
  style: { fillColor: 'rgba(0, 100, 255, 0.4)' },
});
map.addLayer(fillLayer);

// 添加标注
const marker = new BMap.Marker(new BMap.Point(116.404, 39.915));
map.addOverlay(marker);

文档

• 百度地图开放平台
• 百度地图 JSAPI 4.0 官方文档
• API 参考文档

兼容性

• TypeScript >= 4.5
• 适用于百度地图 JSAPI v4.0

API 概览

核心

| 类名 | 说明 | |------|------| | Map | 地图核心类，负责地图初始化、视野控制、图层管理 | | Point | 经纬度坐标点 | | Bounds | 地理矩形范围 | | Pixel | 像素坐标 | | Size | 像素尺寸 |

图层（Layer）

| 类名 | 说明 | |------|------| | FillLayer | 面填充图层，支持纯色、描边、纹理填充 | | LineLayer | 线图层，支持实线、虚线、纹理贴图 | | PointIconLayer | 图标点图层，支持大批量图标点渲染 | | PointShapeLayer | 形状点图层，支持圆形/三角/矩形等形状 | | TileLayer | 自定义瓦片图层，加载百度坐标系瓦片 | | XYZLayer | 第三方标准瓦片图层（XYZ/WMTS/WMS/TMS），内置坐标转换 | | DistrictLayer | 行政区划图层 | | GeoJSONLayer | GeoJSON 数据图层 | | TrafficLayer | 实时交通路况图层 | | DOMLayer | 自定义 DOM 覆盖物图层 | | MVTLayer | 矢量瓦片图层 |

覆盖物（Overlay）

| 类名 | 说明 | |------|------| | Marker | 点标注 | | Label | 文本标注 | | Polyline | 折线 | | Polygon | 多边形 | | Circle | 圆形 | | InfoWindow | 信息窗口 | | CustomOverlay | 自定义覆盖物 | | GroundOverlay | 地面叠加层（图片/Canvas） | | Prism | 3D 棱柱体 | | BezierCurve | 贝塞尔曲线 |

控件（Control）

| 类名 | 说明 | |------|------| | NavigationControl | 平移缩放控件 | | NavigationControl3D | 3D 导航控件 | | ScaleControl | 比例尺控件 | | ZoomControl | 缩放控件 | | MapTypeControl | 地图类型切换控件 | | GeolocationControl | 定位控件 | | CityListControl | 城市选择控件 | | PanoramaControl | 全景控件 |

服务（Service）

| 类名 | 说明 | |------|------| | LocalSearch | 地点检索 | | Geocoder | 地址解析/逆解析 | | DrivingRoute | 驾车路线规划 | | WalkingRoute | 步行路线规划 | | RidingRoute | 骑行路线规划 | | TransitRoute | 公交路线规划 | | Autocomplete | 输入建议 | | Boundary | 行政区划边界 | | Geolocation | 浏览器定位 | | LocalCity | 当前城市定位 | | BusLineSearch | 公交线路查询 |

动画

| 类名 | 说明 | |------|------| | ViewAnimation | 地图视角关键帧动画 |