# Siting

**Repository Path**: void_rangers/siting

## Basic Information

- **Project Name**: Siting
- **Description**: 依赖于高德地图API的原生地图选址插件
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-01-22
- **Last Updated**: 2022-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 插件

## README

# Siting

#### 介绍
依赖于高德地图API的原生地图选址插件

#### 使用说明

```Html
<script src="https://webapi.amap.com/loader.js"></script>
<script src="dish/siting.min.js"></script>
<script>
var siting = new Siting({
    key: 'a0266b43bc833a059cf48c40e63818e0',    //高德 JSAPI 的 Key
    center: [116.396574, 39.992706],            //设置地图初始中心位置，不设置则启用定位获取中心位置
    success(res, data){   //点击地图中 "确认选址" 按钮之后的 回调函数
        /**
         * @param {Object} res  选址的地址信息
         * @param {Object/String} data  传入的参数
         * **/
        console.log('address:', res, data);
    }
});

siting.show({ data: '在回调时需要接收的参数'});  //打开地图选址框
</script>
```

#### 兼容处理
很多情况下不会单独使用，而且嵌入项目中进行，那么之前可能就已经使用或引入过高德的情况，就会提示异常

> AMapLoader Error: 不允许多个版本 JSAPI 混用

##### 解决方法
```javascript
//新增一个 version 属性
new Siting({
    ......
    version: '2.0'  //查找之前引入的高德版本保持一致即可, 目前常用的是 1.4.15版本 和 2.0版本
});
```

> Uncaught (in promise) 禁止多种API加载方式混用

##### 解决方法
```javascript
//直接传入 AMap 对象
new Siting({
    AMap: AMap,  //传入AMap后, key 和 version 的设置就会失效
    ......
})
```


#### 其它

获取高德 JSAPI key 的方式：[https://lbs.amap.com/api/javascript-api/guide/abc/prepare](https://lbs.amap.com/api/javascript-api/guide/abc/prepare)