217 lines
7.4 KiB
Markdown
217 lines
7.4 KiB
Markdown
<p align="center"><a href="http://wzhichao.gitee.io/smartparse/#/smartParse/fq" target="_blank" rel="noopener noreferrer"><img src="http://wzhichao.gitee.io/smart-doc/images/logo.png" alt="smartparse logo"></a></p>
|
||
|
||
### `star` -`1k`后开源后端代码（支持地址更加丰富），快推荐给你身边的小伙伴使用吧
|
||
|
||
<p align="center">
|
||
<a href="https://www.npmjs.com/package/address-smart-parse"><img src="https://img.shields.io/npm/v/address-smart-parse.svg?sanitize=true" alt="Version"></a>
|
||
<a href="https://github.com/wzc570738205/smartParsePro"><img src="https://img.shields.io/github/stars/wzc570738205/smartParsePro?style=social" alt="stars"></a>
|
||
<a href="https://github.com/wzc570738205/smartParsePro"><img alt="GitHub forks" src="https://img.shields.io/github/forks/wzc570738205/smartParsePro?label=Fork&style=social"></a>
|
||
</p>
|
||
|
||
# 智能识别收货地址Pro（支持省市区县街道/姓名/电话/邮编识别）
|
||
### 文档地址：[doc](http://wzhichao.gitee.io/smart-doc/) | [备用(gitee)](http://wzhichao.gitee.io/smartParse) | [备用(语雀)](https://www.yuque.com/books/share/72418abc-287d-4a67-ae3c-dad10928c631?#)
|
||
|
||
### 在线预览： [示例一](https://wangzc.wang/smartParsePro/) [备用地址](http://wzhichao.gitee.io/smartparsepro/)
|
||
|
||
|
||
## 地址数据来源(数据不对请更新此json)
|
||
|
||
更新方法：将此json文件内容复制至同名js里的var pcassCode=xxxx;
|
||
|
||
[pcas-code.json(点击前往)](https://github.com/modood/Administrative-divisions-of-China/blob/master/dist/pcas-code.json)
|
||
|
||
## 港澳台地址
|
||
|
||
参考[港澳台](https://github.com/modood/Administrative-divisions-of-China/issues/27) 可进行自整理
|
||
|
||
## 支持以下数据格式
|
||
### 注意：地址、姓名、电话、邮编用空格或者特殊字符分开
|
||
|
||
特殊字符(可自行添加)：
|
||
```
|
||
~!@#$^&*()=|{}':;',\\[\\].<>/?~！@#￥……&*（）——|{}【】‘；：”“’。，、？-
|
||
|
||
```
|
||
### js支持地址格式
|
||
```
|
||
1. 广东省珠海市香洲区盘山路28号幸福茶庄,陈景勇，13593464918
|
||
2. 马云，陕西省西安市雁塔区丈八沟街道高新四路高新大都荟 13593464918
|
||
3. 陕西省西安市雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918
|
||
4. 西安市雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918
|
||
5. 雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918
|
||
```
|
||
### 接口额外支持关键字多种地址格式
|
||
```
|
||
6. 收货人: 李节霁
|
||
手机号码: 15180231234
|
||
所在地区: 浙江省金华市婺城区西关街道
|
||
详细地址: 金磐路上坞街
|
||
7. 收货人: 马云
|
||
手机号码: 150-3569-6956
|
||
详细地址: 河北省石家庄市新华区中华北大街68号鹿城商务中心6号楼1413室
|
||
```
|
||
## 使用方法
|
||
|
||
### 1.api调用
|
||
>部署腾讯云，单IP调用3条/s限制，需要自行部署请[点击](http://wzhichao.gitee.io/smartparse/#/smartParse/fq)
|
||
|
||
```js
|
||
request url：https://wangzc.wang/smAddress
|
||
request methods: POST
|
||
|
||
request payload:
|
||
|
||
{
|
||
"address": "新疆阿克苏温宿县博孜墩柯尔克孜族乡吾斯塘博村一组306号 150-3569-6956 马云",
|
||
"addressList": [
|
||
"新疆阿克苏温宿县博孜墩柯尔克孜族乡吾斯塘博村一组306号 150-3569-6956 马云",
|
||
"雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918 211381198512096810"
|
||
]
|
||
}
|
||
|
||
//address 字段为单条识别
|
||
//addressList 字段为集合识别 返回在response的list字段中
|
||
|
||
response：
|
||
|
||
{
|
||
"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"
|
||
}
|
||
]
|
||
}
|
||
|
||
```
|
||
api使用推荐axios
|
||
```js
|
||
<script src="https://unpkg.com/axios/dist/axios.min.js"></script>
|
||
|
||
axios({
|
||
method: "post",
|
||
url: "https://wangzc.wang/smAddress",
|
||
data: {
|
||
address: '广东省珠海市香洲区盘山路28号幸福茶庄,陈景勇，13593464918',
|
||
},
|
||
}).then(function (res) {});
|
||
```
|
||
### 2.NPM
|
||
|
||
```sh
|
||
npm install address-smart-parse
|
||
```
|
||
|
||
```js
|
||
import smart from 'address-smart-parse'
|
||
|
||
// console.log(smart('xxxxxxx))
|
||
```
|
||
### 3.script引入
|
||
[在codepen中在线预览](https://codepen.io/wzc570738205/pen/RwrjLbq)
|
||
```
|
||
<script src="js/pcasCode.js"></script>
|
||
<script src="js/zipCode.js"></script>
|
||
<script src="js/address_parse.js"></script>
|
||
|
||
//jsdelivr
|
||
<script src="https://cdn.jsdelivr.net/npm/address-smart-parse@1.0.0/pcasCode.js"></script>
|
||
<script src="https://cdn.jsdelivr.net/npm/address-smart-parse@1.0.0/zipCode.js"></script>
|
||
<script src="https://cdn.jsdelivr.net/npm/address-smart-parse@1.0.0/address_parse.js"></script>
|
||
|
||
|
||
smart("陕西省西安市雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918 211381198512096810")
|
||
```
|
||
|
||
### 4.Python调用
|
||
```
|
||
import requests
|
||
URL='https://wangzc.wang/smAddress'
|
||
data=lambda x : r'{"address":"' + x + '"}'
|
||
address=r'陕西省西安市雁塔区丈八沟街道高新四路高新大都荟710061 刘国良 13593464918 211381198512096810' # address
|
||
requests.post(url=URL,data=data(address).encode('utf-8'))
|
||
print(res.json()) # output
|
||
```
|
||
|
||
|
||
## 生成数据格式
|
||
```json
|
||
{
|
||
"zipCode":"710061",
|
||
|
||
"province":"陕西省",
|
||
|
||
"provinceCode":"61",
|
||
|
||
"city":"西安市",
|
||
|
||
"cityCode":"6101",
|
||
|
||
"county":"雁塔区",
|
||
|
||
"countyCode":"610113",
|
||
|
||
"street":"丈八沟街道",
|
||
|
||
"streetCode":"610113007",
|
||
|
||
"address":"高新四路高新大都荟",
|
||
|
||
"name":"刘国良",
|
||
|
||
"phone":"13593464918",
|
||
|
||
"idCard":"211381198512096810"
|
||
}
|
||
```
|
||
|
||
|
||
##### 地址数据来源：[中华人民共和国行政区划](https://github.com/modood/Administrative-divisions-of-China)
|
||
##### 邮编数据来源：[中华人民共和国邮编](https://github.com/xieranmaya/china-city-area-zip-data/blob/master/china-city-area-zip.json)
|
||
#### LICENSE：[Apache License](https://github.com/wzc570738205/smartParsePro/blob/master/LICENSE)
|
||
#### IDE:致谢[JetBrains](https://www.jetbrains.com/?from=smartParsePro)为本项目提供免费license支持
|
||
[](https://www.jetbrains.com/?from=smartParsePro)
|
||
#### 请作者喝杯咖啡☕️
|
||
|
||
#### 公众号
|
||
|
||
#### 交流群
|
||
|
||
|