Crate cpca

Crate cpca 

Source
Expand description

§CPCA - Chinese Province City Area Parser

中国省市区地址解析库,从地址字符串中提取省、市、区信息。

§功能特性

  • 从自由文本地址中提取省、市、区
  • 支持省份简称(如 “广东” -> “广东省”)
  • 支持直辖市特殊处理
  • 支持不设区的地级市(东莞、中山、儋州、嘉峪关)
  • 内置 2025 年最新行政区划数据(3600+ 条记录)

§快速开始

use cpca::AddressParser;

let parser = AddressParser::new();

// 解析完整地址
let result = parser.parse("广东省深圳市南山区科技园");
assert_eq!(result.province, Some("广东省".to_string()));
assert_eq!(result.city, Some("深圳市".to_string()));
assert_eq!(result.district, Some("南山区".to_string()));

// 支持简称
let result = parser.parse("深圳南山科技园");
assert_eq!(result.province, Some("广东省".to_string()));
assert_eq!(result.city, Some("深圳市".to_string()));

// 标准化地址
let full = parser.normalize("广东", "深圳", None);
assert_eq!(full, "广东省深圳市");

Structs§

AddressParser
地址解析器
ParsedAddress
解析结果
Region
行政区划记录

Enums§

ParseError
地址解析错误

Functions§

normalize
便捷函数:标准化地址
parse
便捷函数:使用全局解析器解析地址