Files
smartParsePro/README.md

221 lines
7.5 KiB
Markdown
Raw Normal View History

2020-06-04 13:53:47 +08:00
![](https://gitee.com/Wzhichao/img/raw/master/uPic/logo14%20.png)
2019-09-12 13:44:29 +08:00
2019-10-14 16:45:06 +08:00
# 智能识别收货地址Pro支持vue/省市区街道四级联动(支持省市区县街道/姓名/电话/邮编/身份证号码识别)
2020-05-19 10:08:37 +08:00
### 文档地址:[语雀](https://www.yuque.com/books/share/72418abc-287d-4a67-ae3c-dad10928c631?#)
2019-10-14 16:09:56 +08:00
2020-06-27 15:03:16 +08:00
### 在线预览:[预览地址](https://wangzc.wang/smartParsePro/)
2019-09-26 11:36:25 +08:00
2020-05-19 10:06:37 +08:00
### 交流Q群[749539640](https://jq.qq.com/?_wv=1027&k=55bQp1O)
2020-05-14 14:45:05 +08:00
> 地址识别问题请@群主
2020-01-02 10:21:45 +08:00
![image.png](https://s2.ax1x.com/2020/01/02/lYkqdx.png)
2019-09-12 13:44:29 +08:00
## 地址数据来源(数据不对请更新此json)
2020-06-11 17:15:41 +08:00
2019-09-12 15:43:01 +08:00
更新方法将此json文件内容复制至同名js里的var pcassCode=xxxx;
2019-09-12 15:43:28 +08:00
2020-03-12 15:56:47 +08:00
[pcas-code.json(点击前往)](https://github.com/modood/Administrative-divisions-of-China/blob/master/dist/pcas-code.json)
2019-09-12 13:44:29 +08:00
2020-06-11 17:15:41 +08:00
## 港澳台地址
2020-06-11 17:16:10 +08:00
参考[港澳台](https://github.com/modood/Administrative-divisions-of-China/issues/27) 可进行自整理
2020-06-11 17:15:41 +08:00
2020-05-13 09:10:08 +08:00
## 支持以下数据格式
### 注意:地址、姓名、电话、邮编、身份证号码【字母大写】用空格或者特殊字符分开!!
2019-09-12 18:02:23 +08:00
特殊字符(可自行添加)
```
~!@#$^&*()=|{}':;',\\[\\].<>/?~@#¥……&*()——|{}【】‘;:”“’。,、?-
```
2019-09-12 18:05:05 +08:00
1. 广东省珠海市香洲区盘山路28号幸福茶庄,陈景勇13593464918
2. 马云,陕西省西安市雁塔区丈八沟街道高新四路高新大都荟 13593464918
3. 陕西省西安市雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918 211381198512096810
4. 西安市雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918 211381198512096810
5. 雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918 211381198512096810
6. 北京市朝阳区姚家园3楼 13593464918 马云
2019-09-12 18:13:46 +08:00
7. 河北省石家庄市新华区中华北大街68号鹿城商务中心6号楼1413室 150-3569-6956 马云
2019-09-12 13:44:29 +08:00
## 不支持的数据格式
陕西省西安市雁塔区丈八沟街道高新四路高新大都荟马云13593464918
## 地址切分规则
2019-09-16 11:41:59 +08:00
1. `省市区(县)街道详细地址`+`电话`+`邮编`+`姓名`+`身份证号码`
2020-05-13 09:10:08 +08:00
## 使用方法
2020-07-01 10:31:54 +08:00
### 1.api调用(部署腾讯云,没有调用限制,需要自行部署请联系群主)
2020-07-01 15:24:20 +08:00
###### 服务器2021-01-09 11:39:42到期若未找到合适赞助服务器到期便停止接口支持(服务器器费用太高,请谅解)
2020-05-13 09:10:08 +08:00
2020-05-15 10:20:55 +08:00
```
2020-05-22 10:15:45 +08:00
request urlhttps://wangzc.wang/smAddress
2020-05-13 09:10:08 +08:00
2020-05-15 10:24:05 +08:00
request methods: POST
2020-05-13 00:09:40 +08:00
2020-05-15 10:24:05 +08:00
request payload:
2020-05-15 10:20:55 +08:00
2020-05-13 00:09:40 +08:00
{
2020-06-01 14:12:24 +08:00
"address": "新疆阿克苏温宿县博孜墩柯尔克孜族乡吾斯塘博村一组306号 150-3569-6956 马云",
"addressList": [
"新疆阿克苏温宿县博孜墩柯尔克孜族乡吾斯塘博村一组306号 150-3569-6956 马云",
"雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918 211381198512096810"
]
2020-05-13 00:09:40 +08:00
}
2020-06-01 14:12:24 +08:00
//address 字段为单条识别
//addressList 字段为集合识别 返回在response的list字段中
2020-05-15 10:24:05 +08:00
response
2020-05-15 10:20:55 +08:00
2020-05-13 00:09:40 +08:00
{
2020-06-01 14:12:24 +08:00
"province": "新疆维吾尔自治区",
"provinceCode": "65",
"city": "阿克苏地区",
"cityCode": "6529",
"county": "温宿县",
"countyCode": "652922",
"street": "博孜墩柯尔克孜族乡",
"streetCode": "652922207",
"address": "吾斯塘博村一组306号",
"phone": "15035696956",
"name": "马云",
"requestNumber": 7,
"list": [
{
"province": "新疆维吾尔自治区",
"provinceCode": "65",
"city": "阿克苏地区",
"cityCode": "6529",
"county": "温宿县",
"countyCode": "652922",
"street": "博孜墩柯尔克孜族乡",
"streetCode": "652922207",
"address": "吾斯塘博村一组306号",
"phone": "15035696956",
"name": "马云"
},
{
"zipCode": "710061",
"county": "雁塔区",
"countyCode": "610113",
"province": "陕西省",
"provinceCode": "61",
"city": "西安市",
"cityCode": "6101",
"street": "丈八沟街道",
"streetCode": "610113007",
"address": "高新四路高新大都荟",
"name": "刘国良",
"phone": "13593464918",
"idCard": "211381198512096810"
}
]
2020-05-13 00:09:40 +08:00
}
2020-05-15 10:20:55 +08:00
2020-05-13 00:09:40 +08:00
```
2020-05-13 09:10:08 +08:00
api使用推荐axios
```
2020-05-15 10:20:55 +08:00
<script src="https://unpkg.com/axios/dist/axios.min.js"></script>
axios({
method: "post",
2020-05-22 10:17:00 +08:00
url: "https://wangzc.wang/smAddress",
2020-05-15 10:20:55 +08:00
data: {
address: '广东省珠海市香洲区盘山路28号幸福茶庄,陈景勇13593464918',
},
}).then(function (res) {});
2020-05-13 09:10:08 +08:00
```
2020-05-13 16:14:32 +08:00
2020-07-01 14:24:17 +08:00
### 2.ES5使用建议下载demo查看引入js顺序以及调用方法或者在线预览
[在codepen中在线预览](https://codepen.io/wzc570738205/pen/RwrjLbq)
2019-09-12 15:39:50 +08:00
```
2020-04-15 11:26:54 +08:00
<script src="js/pcasCode.js"></script>
<script src="js/zipCode.js"></script>
<script src="js/address_parse.js"></script>
2020-05-20 17:08:40 +08:00
//gitee
<script src="http://wzhichao.gitee.io/smartParsePro/js/pcasCode.js"></script>
<script src="http://wzhichao.gitee.io/smartParsePro/js/zipCode.js"></script>
<script src="http://wzhichao.gitee.io/smartParsePro/js/address_parse.js"></script>
2020-05-20 17:14:27 +08:00
2020-04-15 11:26:54 +08:00
2019-09-16 11:41:59 +08:00
smart("陕西省西安市雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918 211381198512096810")
2019-09-12 15:39:50 +08:00
```
2020-05-22 10:15:45 +08:00
### 3.小程序使用如需要自行构建后台json文件在demo/后台json/database_export-sw0HKSJkxA1j.json
2020-04-15 11:32:57 +08:00
将仓库中的```smartWeChat```文件夹拷贝到项目中```app.js```的同级目录
2020-04-15 11:21:43 +08:00
> 详见smartWeChat=>README.md
2020-04-15 11:32:57 +08:00
[文档地址](https://github.com/wzc570738205/smartParsePro/tree/master/smartWeChat)
2020-07-01 15:09:23 +08:00
### 4.1 vue环境下使用
2020-07-01 14:55:36 +08:00
[引入示例在线预览](https://codesandbox.io/s/brave-curie-dy6vt?file=/src/App.vue)
2020-07-01 15:01:33 +08:00
2020-05-13 14:43:26 +08:00
index.html引入js(文件可自行下载部署在自己服务器上)
```
2020-05-20 16:58:43 +08:00
//gitee
2020-05-13 16:09:46 +08:00
<script src="http://wzhichao.gitee.io/smartParsePro/js/pcasCode.js"></script>
<script src="http://wzhichao.gitee.io/smartParsePro/js/zipCode.js"></script>
2020-05-20 17:08:40 +08:00
<script src="http://wzhichao.gitee.io/smartParsePro/js/address_parse.js"></script>
2020-05-13 14:43:26 +08:00
```
2019-10-14 16:09:56 +08:00
2020-07-01 15:15:26 +08:00
xxx.vueaddress_parse.js会暴露全局window方法 smart
2020-05-13 14:43:26 +08:00
```
2020-05-13 14:45:44 +08:00
mounted() {
2020-05-13 14:48:17 +08:00
console.log(window.smart('河北省石家庄市新华区中华北大街68号鹿城商务中心6号楼1413室 150-3569-6956 马云'))
2020-05-13 14:45:44 +08:00
}
2020-05-13 14:43:26 +08:00
```
### 4.2[vue环境下使用](https://github.com/wzc570738205/vue-smart-parse) 这种方法会导致打包体积大
2020-07-01 15:06:14 +08:00
[插件引入在线预览](https://codesandbox.io/s/amazing-cerf-4uycs?file=/src/App.vue)
2019-10-14 16:09:56 +08:00
```
npm install vue-smart-parse -d -s
```
```
// main.js
2019-10-14 16:18:48 +08:00
import smartParse from 'vue-smart-parse';
2019-10-14 16:09:56 +08:00
Vue.use(smartParse)
// App.vue
2019-10-17 09:48:54 +08:00
console.log(this.smartParse('浙江省杭州市西湖区盘山路28号幸福茶庄 陈红 13593464918'));
2019-10-14 16:09:56 +08:00
```
2019-09-12 13:44:29 +08:00
## 生成数据格式
```
{
2019-09-16 11:41:59 +08:00
zipCode:710061
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
province:陕西省
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
provinceCode:61
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
city:西安市
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
cityCode:6101
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
county:雁塔区
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
countyCode:610113
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
street:丈八沟街道
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
streetCode:610113007
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
address:高新四路高新大都荟
2019-09-12 13:44:29 +08:00
2019-09-16 11:41:59 +08:00
name:刘国良
phone:13593464918
idCard:211381198512096810
2019-09-12 13:44:29 +08:00
}
```
2020-05-13 09:26:52 +08:00
2019-09-12 13:44:29 +08:00
##### 地址数据来源:[中华人民共和国行政区划](https://github.com/modood/Administrative-divisions-of-China)
2019-09-12 16:52:30 +08:00
##### 邮编数据来源:[中华人民共和国邮编](https://github.com/xieranmaya/china-city-area-zip-data/blob/master/china-city-area-zip.json)
2020-06-09 10:10:36 +08:00
#### LICENSE[Apache License](https://github.com/wzc570738205/smartParsePro/blob/master/LICENSE)
2020-06-18 09:39:02 +08:00
#### IDE:致谢[JetBrains](https://www.jetbrains.com/?from=smartParsePro)为本项目提供免费的license支持
2020-06-18 09:42:43 +08:00
![](http://cdn.wangzc.wang/LOGO-1.png)
2020-06-18 09:35:16 +08:00
2020-05-13 09:26:52 +08:00
#### 请作者喝杯咖啡☕️
2020-05-21 11:47:07 +08:00
![](http://cdn.wangzc.wang/uPic/cDQzFD.jpg)
2020-05-13 09:26:52 +08:00