pyunits
pyunit-address
Python

字符串地址查询,支持自定义地址词库,解析地址,地址识别,地址抽取,中文地址.

Last updated Jun 23, 2026
95
Stars
17
Forks
0
Issues
0
Stars/day
Attention Score
9
Language breakdown
Python 97.6%
Dockerfile 2.4%
Files click to expand
README

PyUnit-Address [][1]

字符串地址查询,支持自定义地址词库

安装

pip install pyunit-address

说明

该算法有两个词库,一个是全国五级地址,统计时间是2019年。这个地址库是默认加载。不能删除也不能替换。 如果需要提取非规则的地址,则实用深度模型: https://github.com/PyUnit/pyunit-ner 建议两者一起使用,互相补足。

测试

from pyunit_address import *
import time

address = Address(ismaxaddress=True) address.addvaguetext(['红花岗', '花溪']) # 加入地址名称 address.addvaguetext('贵州省-遵义市-遵义县-虾子镇-乐安村-乐石台') # 加入一串有顺序的地址 address.addvaguetext('自定义词库.txt') # 加载词库文件,词库文件中的每一行,可以是一串顺序地址,也可以是一个地址

def all_test(): string_ = '我家在红花岗,你家在贵州贵阳花溪区,他家在贵州省遵义市花溪区' finds = findaddress(address, string) for find in finds: print() print('地址', find) print('补全地址', supplement_address(address, find)) print('纠错地址', correct_address(address, find)) print('--------------------------')

地址 红花岗

补全地址 ['贵州省-遵义市-红花岗区']

纠错地址 贵州省-遵义市-红花岗区

--------------------------

#

地址 贵州贵阳花溪区

补全地址 ['贵州省-贵阳市-花溪区']

纠错地址 贵州省-贵阳市-花溪区

--------------------------

#

地址 贵州省遵义市花溪区 注:这个地址是错误的

补全地址 [] 注:错误的地址无法补全

纠错地址 贵州省-贵阳市-花溪区 注:错误的地址被纠正为对的地址

--------------------------

if name == 'main': start = time.time() all_test() print(time.time() - start) # 0.0002001047134399414秒

查询地址

from pyunitaddress import Address, findaddress

def test(): address = Address(ismaxaddress=True)

# 添加词库,可以是一个字符串、可以是列表字符串、可以是词库文件,一个词语占一行 address.addvaguetext('红花岗') # 在默认词库上追加地址词库 address.addvaguetext('贵州省-遵义市-遵义县-虾子镇-乐安村') # 添加补全地址 address.addvaguetext(['花溪', '贵州省-遵义市-遵义县-虾子镇-乐安村']) # 加载词库列表,替换默认词库 address.addvaguetext('自定义词库.txt') # 加载词库文件,替换默认词库 af = find_address(address, '我家在贵州遵义红花岗区') print(af)

if name == 'main': test()

自动补全地址:输入一句话

from pyunitaddress import Address, supplementaddress

def testsupplementaddress(): address = Address(ismaxaddress=True) asu = supplement_address(address, '我家在遵义县') # [贵州省-遵义市-遵义县] print(asu)

if name == 'main': testsupplementaddress()

自动纠正地址

from pyunitaddress import Address, correctaddress

def correctaddresstest(): address = Address(ismaxaddress=True) print(correct_address(address, '贵州省遵义市花溪区')) # 贵州省-贵阳市-花溪区

if name == 'main': correctaddresstest()

Docker部署

docker pull jtyoui/pyunit-address docker run -d -P pyunit-time

Swagger在线api文档

http://localhost:xxx/docs

寻找地址的请求参数

|参数名|类型|是否可以为空|说明| |------|------|-------|--------| |data|string|YES|输入一句带有地址的句子|

请求示例

#### Python3 Requests测试
import requests

url = "http://127.0.0.1:2312/pyunit/address/find" data = { 'data': '我家在贵州龙里' } response = requests.get(url, params=data).json() print(response)

#### 返回结果
{
  "code": 200,
  "result": [
    {
      "address": "龙里",
      "correct_address": "贵州省-黔南布依族苗族自治州-龙里县",
      "supplement_address": [
        {
          "key": "贵州省-黔南布依族苗族自治州-龙里县"
        }
      ],
      "type": "区县"
    }
  ]
}

增加地址词库请求参数

|参数名|类型|是否可以为空|说明| |------|------|-------|--------| |data|string|YES|输入一句带有地址的句子|

请求示例

#### Python3 Requests测试
import json
import requests

url = "http://127.0.0.1:2312/pyunit/address/add" data = { 'data': json.dumps(['贵州省-贵阳市-观山湖区-观山湖公园', '金融大街', '小吃城']) } response = requests.get(url, params=data).json() print(response)

删除地址词库请求参数

|参数名|类型|是否可以为空|说明| |------|------|-------|--------| |data|string|YES|输入一句带有地址的句子|

请求示例

#### Python3 Requests测试
import json

import requests

url = "http://127.0.0.1:2312/pyunit/address/del" data = { 'data': json.dumps(['金融大街', '小吃城']), } response = requests.get(url, params=data).json() print(response)

#### 返回结果
{
  "code": 200,
  "result": "del success"
}

TODO

  • [x] 自动寻找最长地址长度
  • [x] 全国五级地址新词库
  • [x] 支持自定义地址词库
  • [x] 不支持非规则地址
  • [x] 支持地址自动补全
  • [x] 支持快速高效搜索
  • [x] 支持纠错地址

[1]: https://blog.jtyoui.com

© 2026 GitRepoTrend · pyunits/pyunit-address · Updated daily from GitHub