Skip to content

Commit

Permalink
feat: update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
daiwanxing committed Jan 24, 2023
1 parent e840c5b commit 98d611e
Show file tree
Hide file tree
Showing 2 changed files with 71 additions and 1 deletion.
69 changes: 69 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
# BMap-loader

BMap-loader 是一个非官方的地图 jsAPI 加载器, 目标是为用户提供一个简洁易用的创建百度地图的插件。 BMap-loader 的灵感来源于 [amap-jsapi-loader](https://www.npmjs.com/package/@amap/amap-jsapi-loader), 但目前仍有部分功能待实现中, 如果您愿意贡献代码,欢迎提 PR。

BMap-loader 特性如下:

- 支持以 UMD 和 ESM 两种方式使用;
- 以异步加载的方式加载百度地图;
- 支持同时加载 JSAPI JSAPI-GL 两个地图版本;
- 支持多次加载插件;
- 对于加载地图的错误用法给予报错处理;

# 使用方式

## 以 npm 方式引用

```shell
$ npm install bmap-loader --save
```

```js
import BMapLoader from "bmap-loader";

BMapLoader({
v: "1.0",
type: "webgl",
ak: "填写你的ak密钥",
}).then((BMapGL) => {
const map = new BMapGL.Map("map");
map.centerAndZoom(new BMapGL.Point(116.404, 39.915), 11);
map.addControl(
new BMapGL.MapTypeControl({
mapTypes: [BMAP_NORMAL_MAP, BMAP_HYBRID_MAP],
})
);
map.enableScrollWheelZoom(true);
});
```

## 以 js 脚本的方式引用

```html
<script src="../dist/bmap-loader.umd.js"></script>
<script>
BMapLoader({
v: "1.0",
type: "webgl",
ak: "填写你的ak密钥",
}).then((BMapGL) => {
const map = new BMapGL.Map("map");
map.centerAndZoom(new BMapGL.Point(116.404, 39.915), 11);
map.addControl(
new BMapGL.MapTypeControl({
mapTypes: [BMAP_NORMAL_MAP, BMAP_HYBRID_MAP],
})
);
map.enableScrollWheelZoom(true);
});
</script>
```

## RoadMap

- [ ] 改用 typescript 重写,增强智能提示。
- [ ] 支持加载百度地图的插件库。

# License

MIT
3 changes: 2 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "bmap-loader",
"version": "0.0.1",
"version": "0.0.2",
"description": "一个易用的安装百度地图的js加载器, 灵感来源于高德地图官方的amap-jsapi-loader",
"main": "./dist/bundle.es.js",
"type": "module",
Expand All @@ -12,6 +12,7 @@
"bmap-loader",
"sdk"
],
"files": ["dist"],
"author": "Wonder Dai",
"license": "MIT",
"bugs": {
Expand Down

0 comments on commit 98d611e

Please sign in to comment.