addrparser 根据经纬度解析省市区信息工具包

程序名称：addrparser

授权协议: Apache

操作系统: 跨平台

开发语言: Java

addrparser 介绍

用于离线高效的解析中国范围内的经纬度为省市区信息，省市区信息包括: 行政区划编码、行政区划中文名称、行政区域的中心点经纬度，行政区域的边界点经纬度集合。

离线数据可基于文件，也可存于MysqL数据库中。

依赖安装

<dependency>
    <groupId>tech.spiro</groupId>
    <artifactId>addrparser</artifactId>
    <version>1.0</version>
</dependency>

使用说明

china-
region-20180418.zip 解压后得到文件：china-
region.json，文件中包括了所有的省市区行政区域信息，包括编码、名称、中心点、边界点集合。

经纬度数据基于GCJ-02坐标系

方式一 （文件）

直接使用china-region.json文件作为基础数据。

示例代码：

// china-region.json文件作为基础数据
RegionDataInput regionDataInput = new JSONFileRegionDataInput(path/china-region.json);

// 创建并初始化位置解析引擎，一般配置为全局单例
LocationParserEngine engine = new LocationParserEngine(regionDataInput);
// 初始化，加载数据，比较耗时
engine.init();

// 执行解析操作
Location location = engine.parse(118.750934,32.038634);

// 获取省市区信息
regioninfo provInfo = location.getProv();
regioninfo cityInfo = location.getCity();
regioninfo districtInfo = location.getdistrict();

方式二 （MysqL）

将数据导入MysqL数据库，使用MysqL中数据作为基础数据。

下载数据导入工具：
addrparser-1.0.tar.gz

解压后，进入addrparser/bin目录，执行jsonfile2MysqL.sh (Linux) 或 jsonfile2MysqL.bat
(Windows)

usage: JSONFile2MysqL
 -a,--password <arg>     MysqL password
 -d,--db <arg>           MysqL database
 -f,--file <arg>         Json region data file path  上述china-region.json文件的路径
 -h,--host <arg>         MysqL host
 -i,--init               Init table schema
 -p,--port <arg>         MysqL port, default 3306
 -t,--table-name <arg>   Default: 'region_data', Region data table name
 -u,--user <arg>         MysqL user

如果不指定-t，使用默认表名region_data

示例代码：

// javax.sql.DataSource 数据源
DataSource ds = ...;

// 关系型数据库区域数据输入
RegionDataInput regionDataInput = new RdbmsRegionDataInput(ds);

// 如果上述命令如果指定了定制的表名，则该处也要指定表名。
// RegionDataInput regionDataInput = new RdbmsRegionDataInput(ds, customTableName);

// 创建并初始化位置解析引擎，一般配置为全局单例
LocationParserEngine engine = new LocationParserEngine(regionDataInput);
// 初始化，加载数据，比较耗时
engine.init();

// 执行解析操作
Location location = engine.parse(118.750934,32.038634);

// 获取省市区信息
regioninfo provInfo = location.getProv();
regioninfo cityInfo = location.getCity();
regioninfo districtInfo = location.getdistrict();

addrparser 官网

https://github.com/hsp8712/addrparser