ldwonday / zh-address-parse

全网识别准确度最高的**大陆收货地址智能解析

China's delivery address parse

New Feature

增加自定义解析国家统计局数据，数据更新至 2020-11-20，代码：https://github.com/ldwonday/zh-address-parse/blob/master/app/lib/getMcaGovData.js

Preview

Test page

Syntax

AddressParse(address[, [option|0|1]])

option可选参数属性列表

参数名	说明	类型	是否必填	默认值
type	解析方式	Number	否	0
textFilter	预过滤字段	Array	否	[]
nameMaxLength	中文名最大长度	Number	否	4
extraGovData	额外的省市区数据	{ city?: GovData[]; area: GovData[]; province: GovData[] }	否	-

extraGovData 定义如下：

type GovData = {
    code: string;
    provinceCode?: string;
    cityCode?: string;
    name: string;
}

Usage

npm

npm i zh-address-parse -s

import AddressParse from 'zh-address-parse'

import

import AddressParse from './dist/zh-address-parse.min.js'
// options为可选参数，不传默认使用正则查找
const options = {
  type: 0, // 哪种方式解析，0：正则，1：树查找
  textFilter: [], // 预清洗的字段
  nameMaxLength: 4, // 查找最大的中文名字长度
  extraGovData: { city: [{ name: 'name', code: 'code', provinceCode: 'provinceCode' }], province: [{ name: 'name', code: 'code' }], area: [{ name: 'name', code: 'code', provinceCode: 'provinceCode', cityCode: 'cityCode' }] }
}
// type参数0表示使用正则解析，1表示采用树查找, textFilter地址预清洗过滤字段。
const parseResult = AddressParse('your address', options)
// The parseResult is an object contain { province: '', name: '', city: '', area: '', detail: '', phone: '', postalCode: '' }

script引入

<script async defer src="./zh-address-parse.min.js"></script>
<script>
    const parse = () => {
        const onTextAreaBlur = (e) => {
            const address = e.target.value
            const parseResult = window.ZhAddressParse(address, { type: 0, textFilter: ['电話', '電話', '聯系人'] })
            // The parseResult is an object contain { province: '', name: '', city: '', area: '', detail: '', phone: '', postalCode: '' }
            console.log(parseResult)
            $('#result').empty();
            $('#result').append(`<ul>${Object.entries(parseResult).map(([k, v]) => `<li>${k}：${v}</li>`).join('')}</ul>`)
        }
        $('#addressContent').bind('input propertychange', onTextAreaBlur)

        $('#addressList li').on('click', (e) => {
            $('#addressContent').val(e.target.innerText)
            $('#addressContent')[0].dispatchEvent(new Event('input'));
        })
    }

    parse()
</script>

Setup

Install dependencies

$ npm install

Development

Run the local webpack-dev-server with livereload and autocompile on http://localhost:8080/

$ npm run dev

Deployment

Build the current application

$ npm run build

Donate

您的支持是我前进的动力，更好的支持开源事业！~

Developed with Open Source Licensed WebStorm

zh-address-parse's Issues

人名与地名混淆了

输入：南宫雪 重庆市县酉阳土家族苗族自治县龙潭镇龙潭一中新校门17648207282

期望：
phone：[phone]
province：重庆市
city：
area：
detail：县酉阳土家族苗族自治县龙潭镇龙潭一中新校门
name：南宫雪
postalCode：

实际：
phone：[phone]
province：河北省
city：邢台市
area：南宫市
detail：重庆市县酉阳土家族苗族自治县龙潭镇龙潭一中新校门
name：雪
postalCode：

是否是智能识别？

想问一下，这个是否能够调用百度地图，来进行缺失信息的补充。

建议以 npm package 形式发布

建议提供 npm 包，以便于 vue/react 环境下使用。

山东省 济宁市 北湖区 。无法识别到北湖区

校验非常不准

张彤，15776993213，黑龙江省 大兴安岭地区 加格达奇区 铁路南小区29号楼4单元5658sf

上面2个都不行。

无法解析市级县

如 重庆市 垫江县 太平镇
province：重庆市
city：县
area：垫江县

**和田市无法被解析成"市"

**维吾尔自治区和田地区和田市xx小区

识别结果
phone：
province：**维吾尔自治区
city：和田地区
area：
detail：市xx小区
name：和田
postalCode：

地址识别不准确，建议把手机号之前的，为百家姓开头的字符串优先作为姓名

SyntaxError: Invalid regular expression: Nothing to repeat (at zh-address-parse.min.js:1:113456)

Bad case: 福利待遇:(底薪 全勤+补助）+成都，地址1：莱蒙盒马鲜生
Problem: 成都前面带了”+“符号
Advice: 应该先把一些正则敏感的符号转义一下。

能否支持身份证提取？

希望能改进地址的识别模糊化，很多地址识别太离谱了

希望能改进地址的识别模糊化，很多地址识别太离谱了，地址的识别要模糊化不要太遵守地址列表。
看看一下地址：
王小梅15273551234湖南省郴州市桂东县桂东县清泉镇
莫席辉13667721234广西壮族自治区柳州市柳北区跃进路42号4栋20楼
韩仁伟,18555605568,安徽省安庆市太湖县新仓镇，塔山村，前进组

ts声明文件中option中的textFilter应该是string|string[]

现在在ts中引用申明只能是string

如果能公开部分代码就好了。

我还有其他的需求，在这之前还需要校验下别的东西。

直辖市地址解析失败

使用测试地址：https://ldwonday.github.io/zh-address-parse/
上海市黄浦区瞿溪路1032弄3号103
预期结果
province：上海市
city：上海市
area：黄浦区
detail：瞿溪路1032弄3号103
……
实际结果
province：上海市
city：徐汇区
area：
……

有如地址"重庆市涪陵区荔枝街道天籁城12栋29-10"，也得不到预期结果

需要java语言解析^_^

无法正确识别东莞市、中山市这类直接下辖乡镇街道的城市信息

“广东省东莞市塘厦镇” 错误的将塘厦镇识别为名称（name）

你好，报一个问题

深圳市罗湖区凤凰路中山花园1栋582室，刘蓝琴，电話13111111111
这个地址是你自己写在上面的，然后都不对，是不是要把“电话”这种关键字先剔除掉啊

姓名和城市识别出错

邓正怡, 13808880090, **,广东,深圳市,福田区,莲花街道,, 长城盛世家园8栋88G

识别结果
phone：[phone]
province：广东省
city：深圳市
area：福田区
detail：邓正怡**莲花街道长城盛世家园8栋88G
name：广东
postalCode：
areaCode：440304

座机是还不支持识别吗，能否增加座机识别？

例如以下：
徐志摩0212222333上海市崇明区45-5号
徐志摩021-2222333上海市崇明区45-5号
徐志摩059122223333上海市崇明区45-5号
徐志摩0591-22223333上海市崇明区45-5号

没有区县统统不行

广东省

两个识别问题

1。地址前面有“**”或其它文字会被识别到“name”里面去～
2。区县后面字数如果少于中文名最大长度会被识别到“name”里面去～如“江西省抚州市临川区公安宿舍”和“辽宁省盘锦市盘山县东郭镇”

打算试着开个restful的接口，没有成功

git上十几个解析地址的项目，试下来这个是最靠谱的。我们的项目是java的，需要开个restful的接口获取结果。无奈本人实在是前端水平太差，没有成功。

哪位老大肯出手帮助一下吗，万分感谢。

不输入姓名，输入电话和地址且地址精确到街道或者路，就会把街道赋值给名称

有空额时识别出来的姓名不对，希望能修复

江苏省 苏州市 平江区 干将东路608号江苏大厦3楼 215000 徐天宇 13962162160
识别出来的姓名不对，希望能修复

广东省东莞市凤岗镇沙岭立交路中侧凤岗汽车客运站

{
area: ""
areaCode: ""
city: "东莞市"
detail: "凤岗镇沙岭立交路中侧凤岗汽车客运站"
name: ""
phone: ""
postalCode: ""
province: "广东省"
}
没有areaCode吗？

能否搞成一个API这样好用一点？

能否搞成一个API这样好用一点？

无法匹配到某些区的数据

例如安徽省 合肥市 新站综合开发试验区和安徽省 合肥市 滨湖新区

2021年新增区划无法被解析

民政部未提供2021年的完整区划列表，只给了变更列表，能否提供自定义方式，手动添加新区划，或修改已有区划？

行政区域划分码缺了很多县级地址

比如说，广东省中山市下还有县级的地址如小榄镇，东区街道等等的。直接用那份行政区域划分码来匹配，导致匹配不到这些没有在表里的那些县级地址，省市区三级就缺了区了。

12-16行代码过滤行政区划哪里是否有问题呢？

对同一个数组遍历的同时又作移除操作，是否会有问题呢？

无法识别分机号

识别不了收货人为英文名的情况

eg:
200801000001，Mary，13688888888，济源市沁园街道花花花路888号
识别结果：
phone：[phone]
province：河南省
city：济源市
area：
detail：沁园街道花花花路888号Mary
name：
postalCode：
areaCode：

能实现批量处理吗？

我这边有一个excel表格，里面包含了几万条地址信息，请问大佬，怎么能够实现批量处理啊？我是小白，完全不会用……

识别错误：济源市 为河南省直辖县级市，但识别后的结果却把 济源市 划归到了 郑州市

建议增加识别街道名称

街道名称数据可以使用国家邮局的。

如：
收货人: 杨燕艳
手机号码: [phone]
所在地区: 广东省深圳市龙岗区龙岗街道
详细地址: 格水村三巷十号三楼

期望：
姓名:杨燕艳
电话:[phone]
邮编:undefined
省:广东省
市:深圳市
区:龙岗区
街道:龙岗街道
详细地址:格水村三巷十号三楼

返回值没有省编码和市区编码

地区未识别出来

姓名：张三 地址：云南迪庆州德钦县升平镇 214国道西50米梅里雪山国家公园-雾浓顶景区润境梅里设计师酒店 13911111111

phone：[phone]
province：云南省
city：迪庆藏族自治州
area：
detail：214国道西50米梅里雪山国家公园-雾浓顶景区润境梅里设计师酒店州德钦县升平镇
name：张三
postalCode：

少了 area

北京市北京市朝阳区XXXX这样的地址识别不出来

如题

请问vue项目怎么引入呢

按照你markdown上面的教程我引入失败了

您好 手机号匹配稍微有些瑕疵，请问我该怎么修改？

您好 手机号匹配稍微有些瑕疵，请问我该怎么修改？
比如这种格式（200801000001，张三，13688888888，广东省 深圳市 福田区 花花花路888号） 就会把订单号匹配成手机号，
JS文件咋修改呢 有没开发版

某些地区只能识别的时候会出现内存溢出的错误

重庆市南岸区兰花路兰湖天小区
邓先森
15808888888
这个地址粘贴自动识别之后，直接会提示内存溢出

手机号码中的86识别的时候被删除了

例如：马云 150008888626 上海市嘉定区人民路888弄8号808室
识别结果里面的街道地址：人民路888弄8号808室6
手机号是：150008882