5级行政区域数据

Rust 实现 省市县镇村 数据查询 名称模糊搜索 及坐标对应城市搜索

c的ffi示例，可以通过ffi转接到其他语言上,示例:php扩展

包含以下数据：

1. 五级行政区域数据库: sqlite数据 csv数据

2. 县区级经纬度坐标数据 sqlite数据 csv数据

3. 预计下一步引入：ip对应城市数据

基于 axum 的示例

``` cd examples/axum ; cargo run

测试接口

curl 'http://127.0.0.1:8080/area/geo?lat=22.57729&lng=113.89409' curl http://127.0.0.1:8080/area/list?code=1101 curl http://127.0.0.1:8080/area/related?code=4414 curl http://127.0.0.1:8080/area/find?code=4414 curl http://127.0.0.1:8080/area/search?key_word=%E6%B7%B1%E5%9C%B3%20%E5%B8%83%E5%90%89 ```

代码示例:

1. 请先下载CSV数据文件到你的项目：城市数据示例 城市坐标示例

csv数据源使用示例

```toml

cargo.toml 默认仅引入:data-csv

area-db = { version = "~0.1.*"} ```

rust let code_path = PathBuf::from("data/2023-7-area-code.csv.gz"); let geo_path = PathBuf::from("data/2023-7-area-geo.csv.gz"); let data = area_db::CsvAreaData::new( area_db::CsvAreaCodeData::from_inner_path(code_path, true).unwrap(), Some(area_db::CsvAreaGeoData::from_inner_path(geo_path, true).unwrap()), ); let area = area_db::AreaDao::from_csv_mem(data, AreaStoreMemory::default()).unwrap(); //使用文件索引，减少内存使用，接口速度比mem，但省内存 // let area = area_db::AreaDao::from_csv_disk(data, AreaStoreDisk::new(PathBuf::from("./tmp"), None).unwrap()).unwrap();

1. 请先下载sqlite数据到你的项目 内置的包含5级行政区域跟坐标的sqlite数据 解压后使用

如果你已经装了lib-sqlite的库，可用:data-sqlite 会使用系统的sqlite库. 具体参见crate:rusqlite实现

如果你未安装lib-sqlite的库，可用:data-sqlite-source 会通过c源码编译sqlite库. sqlite源码通过子模块git submodule update --init获取

sqlite数据源使用示例

```toml

cargo.toml

area-db = { version = "~0.1.*", default-features=false,features=["data-sqlite-source"]} ```

```rust let conn = "data/area-data.db"; let sqlite = areadb::SqliteAreaData::new( areadb::SqliteAreaCodeData::frompath(PathBuf::from(&conn)), Some(areadb::SqliteAreaGeoData::from_path(PathBuf::from(&conn))), );

let area = areadb::AreaDao::fromsqlitemem(sqlite, AreaStoreMemory::default()).unwrap(); //使用文件索引，减少内存使用，接口速度比mem，但省内存 // let area = areadb::AreaDao::fromsqlitedisk(sqlite, AreaStoreDisk::new(PathBuf::from("./tmp"), None).unwrap()).unwrap(); ```

1. 使用mysql作为数据来源：表定义 数据可以把以上的csv数据导入进去

mysql数据库作为数据源的示例

```toml

cargo.toml

area-db = { version = "~0.1.*", default-features=false,features=["data-mysql"]} ```

rust let pool = "mysql://***:***@127.~0.0.*:3306/***"; let mysql = area_db::MysqlAreaData::new( area_db::MysqlAreaCodeData::from_uri(pool), Some(area_db::MysqlAreaGeoData::from_uri(pool)), ); let area = area_db::AreaDao::from_mysql_mem(mysql, AreaStoreMemory::default()).unwrap(); //使用文件索引，减少内存使用，接口速度比mem，但省内存 // let area = area_db::AreaDao::from_mysql_disk(mysql, AreaStoreDisk::new(PathBuf::from("./tmp"), None).unwrap()).unwrap();

1. 数据更新时重新加载数据

rust let area = area_db::AreaDao::from_*(...).unwrap(); area.geo_reload().unwrap();//重新加载GEO数据 area.code_reload().unwrap();//重新加载CODE数据

1. FFI导出

默认不引入 lib-clib ,需要FFI请开启 cargo build --features "lib-clib" ```toml

修改 cargo.toml 添加 lib-clib

area-db = { version = "~0.1.*",features=["lib-clib"]} ```

可用的查询方法

1. 查询 省市县镇村 可用在地址选择多级联动接口

rust let child="";//空列出省级，把省级的code转入列出市级..依次完成 let res = area.code_childs(child).unwrap(); println!("{}", &res);

1. 查询 指定code 的相关数据

rust let child="441403133";//地址code let res = area.code_related(child).unwrap(); println!("{}", &res);

1. 查询 指定code 的详细地址信息

可用于系统内的code到地址转换

rust let child="441403133";//地址code let res = area.code_find(child).unwrap(); println!("{}", &res);

1. 搜索任意地址，返回匹配的地址信息

rust let child="guang dong";//地址信息 在比如: 广东 布吉 let limit = 10;//返回匹配数量 let res = area.code_search(child, limit).unwrap(); println!("{}", &res);

1. 返回指定坐标的地址信息

可用手机根据geo信息自动填写当前位置收货地址

目前到市一级，因为只找到了市一级的坐标数据

rust let res = area.geo_search( 26.61474, 114.13548 , ).unwrap(); println!("{}", &res);

1. 根据当前ip获取地址信息【待定，后面会补上】