Golang中国地址生成扩展包

背景

在开发项目的过程中，经常会需要生成一些国内的地址数据。在之前使用 PHP 和 Node.js 开发时，我曾使用过一些中国地址生成的扩展包，帮助快速生成符合规范的地址数据。然而，转向 Golang 进行项目开发时，我发现没有合适的地址生成工具。因此，我决定自己编写一个 Golang 的中国地址生成包，方便今后的开发使用。

包地址

https://github.com/GoFinalPack/chinese-address-generator

使用

安装依赖

go get github.com/GoFinalPack/chinese-address-generator@v1.0.0

目前更新到 v1.0.0 版本

代码中使用

生成一级地址

g := chineseaddressgenerator.Generator{}
g.Init()
level1 := g.GenerateLevel1()  // 一级地址
fmt.Println(level1)           // {"code": "230000", "region": "黑龙江省"}

生成二级地址

g := chineseaddressgenerator.Generator{}
g.Init()
level2 := g.GenerateLevel2()  // 二级地址
fmt.Println(level2)           // {"code": "620100", "region": "甘肃省兰州市"}

生成三级地址

g := chineseaddressgenerator.Generator{}
g.Init()
level3 := g.GenerateLevel3()  // 三级地址
fmt.Println(level3)           // {"code": "350205", "region": "福建省厦门市海沧区"}

生成四级地址

g := chineseaddressgenerator.Generator{}
g.Init()
level4 := g.GenerateLevel4()  // 四级地址
fmt.Println(level4)           // {"code": "310113111000", "region": "上海市市辖区宝山区高境镇"}

生成完整的地址

g := chineseaddressgenerator.Generator{}
g.Init()
fullAddress := g.FabricateFullAddress()  // 生成完整地址
fmt.Println(fullAddress)                 // {"code": "622926209000", "region": "甘肃省临夏回族自治州东乡族自治县五家乡1115号182室", "buildNo": 1115, "roomNo": 182}

PS: 上述生成的地址纯属虚构，如有雷同，纯属巧合。生成规则为：(001-1400)号(101-909)室。

包结构

.
├── README.md
├── generator.go
├── go.mod
├── tests
│   ├── generator_test.go
│   └── readLeave_test.go
└── utils
    ├── data
    │   ├── level3.json
    │   └── level4.txt
    └── utils.go

• level3.json 文件中存储的是省、市、区数据
• level4.txt 文件中存储的是街道、乡镇等数据

其他语言的扩展包

• PHP扩展包
• Node扩展包

这些扩展包提供了类似的功能，可以在不同的开发环境中使用，帮助你生成符合中国地址规范的数据。