# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V6.0.5 | 完善了地图组件，对“地图JS API”功能调用进行通用指令封装；支持调用地图服务（百度和高德）对应的任意开放js对象接口，实现地图对外提供的基于地图本身的相关功能 | 2024年1月11日 |
# 用户场景
对“地图JS API”功能调用进行通用指令封装，支持调用地图服务（百度和高德）对应的任意开放js对象接口实现业务功能
# 功能介绍
* 苍穹服务端插件通过调用该通用接口（控件方法），从而可以实现地图对外提供的基于地图本身的相关功能，如绘制图形、路线导航等。详情可查阅地图服务商的js api：
* [百度地图](https://lbsyun.baidu.com/index.php?title=jspopularGL)
* [高德地图](https://lbs.amap.com/api/javascript-api-v2/summary)
# 适用版本
金蝶云苍穹BOS_V6.0.5及以上
# 使用方法
插件编写（以百度地图添加覆盖层 & ks脚本为例）
```
var mapControl = this.getView().getControl('kdtest_mapcontrolap');
var args = 'var polygon = new BMapGL.Polygon([new BMapGL.Point(116.387112,39.920977),new BMapGL.Point(116.385243,39.913063),new BMapGL.Point(116.394226,39.917988),new BMapGL.Point(116.401772,39.921364),new BMapGL.Point(116.41248,39.927893)], {strokeColor:"blue", strokeWeight:2, strokeOpacity:0.5});map.addOverlay(polygon);' // 将百度地图中执行的js代码全都转换为字符串，其中地图实例的命名必须为map
mapControl.executeCustomEvent(args)
```
# 注意事项
*1、如果地图使用的是默认地图的话，则不支持通过该指令方法进行调用。租户需要在系统中配置自己的地图服务*
*2、启用的地图服务需要与当前调用api的地图类型一致*
*3、由于高德地图是通过懒加载插件的方式进行功能调用，在调用对应的api功能时，确保插件已经加载，如果没有加载的话，可通过异步代码加载，即在args参数中先初始化插件:*
```
var arags = 'AMap.plugin('AMap.Toolbar', () => { /*待执行的逻辑*/})'
```
