# 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| --- | --- | --- |
| V6.0.5 | 完善了地图组件，对“服务端api接口”进行通用指令封装；支持调用地图服务（百度和高德）对应的任意开放接口，实现地图对外提供的服务端api的相关功能 | 2024年1月11日 |
# 用户场景
1、对“服务端api接口”进行通用指令封装，支持调用地图服务（百度和高德）对应的任意开放接口实现业务功能
2、服务端api接口调用的结果数据，要返回服务端给到服务端插件使用
# 功能介绍
* 苍穹服务端插件通过调用该通用方法，从而可以实现地图对外提供的服务端api的相关功能，如地理编码、路径规划等
* [百度地图](https://lbsyun.baidu.com/faq/api?title=webapi)
* [高德地图](https://lbs.amap.com/api/webservice/guide/api)
# 适用版本
金蝶云苍穹BOS_V6.0.5及以上
# 使用方法
插件编写（以ks脚本为例）
```
// 百度地图添加逆地理编码
var param = {
url: 'https://api.map.baidu.com/location/ip',
requestMethod: 'GET',
query: {
ip: '111.206.214.37',
coor: 'bd09ll'
},
body: {}
}
this.getView().executeClientCommand('callMapServerApi', param)
// 高德地图调用post接口
var param = {
url: 'https://restapi.amap.com/v4/grasproad/driving',
requestMethod: 'POST',
body: [{"x":116.478928,"y":39.997761,"sp":19,"ag":0,"tm":1478031031},{"x":116.478907,"y":39.998422,"sp":10,"ag":0,"tm":2},{"x":116.479384,"y":39.998546,"sp":10,"ag":110,"tm":3},{"x":116.481053,"y":39.998204,"sp":10,"ag":120,"tm":4},{"x":116.481793,"y":39.997868,"sp":10,"ag":120,"tm":5},{"x":116.482898,"y":39.998217,"sp":10,"ag":30,"tm":6},{"x":116.483789,"y":39.999063,"sp":10,"ag":30,"tm":7},{"x":116.484674,"y":39.999844,"sp":10,"ag":30,"tm":8}]
}
this.getView().executeClientCommand('callMapServerApi', param)
```
param参数结构体说明:
```
param = {
url: '', // 调用的api地址
requestMethod: '', // 调用方式
query: {}, // 查询参数，如ip=111.206.214.37&coor='bd09ll'的话，需转为{ ip: '111.206.214.37', coor: 'bd09ll'}的形式
body: {} // 当调用方式为POST时传入body参数
}
```
前端获取api响应后，会通过自定义事件将响应数据发送到后端。插件可以通过`getResponse`方法进行读取：
# 注意事项
*1、如果地图使用的是默认地图的话，则不支持通过该指令方法进行调用。租户需要在系统中配置自己的地图服务*
*2、启用的地图服务需要与当前调用api的地图类型一致*
