关于后端:从区划边界geojson中查询经纬度坐标对应的省市区县乡镇名称开源Java工具内存占用低高性能

坐标边界查问工具：AreaCity-Query-Geometry

本工具外围性能：应用jts库从省市区县乡镇边界数据（AreaCity-JsSpider-StatsGov开源库）或geojson边界数据文件中查找出和任意点、线、面有相交的矢量边界，内存占用低，性能低劣。

GitHub地址：https://github.com/xiangyuecn/AreaCity-Query-Geometry
Gitee镜像库：https://gitee.com/xiangyuecn/AreaCity-Query-Geometry

次要个性：

• 查问一个坐标点对应的城市信息；
• 查问一条门路通过的所有城市；
• 查问一个矢量范畴笼罩的所有城市；
• 查问一个城市或下一级所有边界数据（WKT格局）；
• 反对通过HTTP API服务进行查问调用；
• 反对通过Java代码进行查问调用；
• 源码简略，包含测试bat脚本共5个文件，无需IDE即可批改和运行，copy即用。

能够只copy AreaCityQuery.java 文件到我的项目中应用，我的项目中引入jts库，就能应用 AreaCityQuery 中的所有查找性能了。也能够clone整个我的项目代码双击 编译和运行Test.java间接测试.bat 即可间接运行测试。

API和图形界面：此工具自带了一个HTTP API服务，运行测试而后通过菜单启动此服务，而后就能够间接在浏览器上拜访这些接口；此API接口能够间接在 ECharts Map四级下钻在线测试和预览 页面的自定义数据源中进行调用测试，页面会立刻绘制查问进去的边界图形。

效果图：

HTTP API图形界面：

控制台运行：

性能测试数据

测试数据源：AreaCity-JsSpider-StatsGov开源库2021.220321.220428版本下载的ok_geo.csv文件按省市区导出成不同的geojson文件。

测试采纳开启多线程进行随机坐标点的查问（Test.java控制台5号菜单），测试机器配置：8核 2.20GHz CPU，SSD 硬盘。

测试一：Init_StoreInWkbsFile 内存占用很低（性能受IO限度）

Init_StoreInWkbsFile：用加载数据到结构化数据文件的模式进行初始化，举荐应用本办法初始化，边界图形数据存入结构化数据文件中，内存占用很低，查问时会重复读取文件对应内容，查问性能耗费次要在IO上，IO性能极高问题不大。

测试二：Init_StoreInMemory 内存占用和json文件差不多大（性能奔放）

Init_StoreInMemory：用加载数据到内存的模式进行初始化，边界图形数据存入内存中，内存占用和json数据文件大小差不多大，查问性能极高；另外可通过设置 AreaCityQuery.SetInitStoreInMemoryUseObject=true 来进一步晋升性能，但内存占用会增大一倍多，省市区三级单核可达到 15000 QPS。

参考：数据库查问测试比照

数据库查问坐标点：POINT(114.044346 22.691963) 深圳市 龙华区；POINT(116.055588 39.709385) 北京市 房山区（查问受内蒙envelope烦扰影响性能）

查问坐标对应的省市区县乡镇名称

应用此工具进行坐标省市区县乡镇查问，先要筹备一个省市区县乡镇的边界geojson数据文件。

数据中有哪一级的边界就能查问出哪一级的名称；比方你只有区级的数据，那么给一个坐标就能查问出此坐标所在的区县名称（需另外查找出下级的省市名称）；如果有省市区三级的边界，那一次性就能查问出省市区三级的名称，如果有乡镇的边界，就能查问出乡镇这级的名称。

步骤一：筹备好省市区县乡镇边界的geojson文件

如果你没有边界json文件，能够按以下步骤取得最新的全国省市区县乡镇边界数据json文件：

1. 到开源库下载省市区边界数据ok_geo.csv文件: https://github.com/xiangyuecn… （github可换成gitee）；
2. 下载开源库外面的AreaCity-Geo格局转换工具软件；
3. 关上转换工具软件，抉择ok_geo.csv，而后导出成geojson文件即可（默认会导出全国的省级数据，通过填写不同城市名前缀能够导出不同城市）。

如果你有多个geojson文件，须要合并成一个才行，能够通过下面下载的 AreaCity-Geo格局转换工具软件 中的 高级性能–GeoJSON多个文件合并成一个文件 来合并。

步骤二：运行测试程序进行初始化

双击 编译和运行Test.java间接测试.bat 运行测试控制台程序；依据控制台菜单命令进行初始化，有两种初始化形式，轻易哪种都行：

1. Init_StoreInWkbsFile：内存占用很低，但查问速度绝对StoreInMemory慢很多，但也很快的，举荐用此办法初始化；
2. Init_StoreInMemory：内存占用大一点，但查问速度十分快。

抉择了初始形式后会要求填写geojson文件门路，填写上一步筹备好的json文件残缺门路即可；或者间接将json文件放到程序根目录，会主动初始化。

步骤三：查问坐标取得省市区名称

初始化实现后，所有的菜单都能够应用了，能够间接在控制台中应用对应的菜单进入菜单查问性能，而后输出坐标查问即可。

倡议应用HTTP API来进行查问，在菜单中启动好HTTP服务后，就能通过网址拜访查问接口，或者间接应用在线的可视化界面进行查问操作：

附：通过Java代码进行查问

//先初始化，全局只会初始化一次，每次查问前都调用即可（查问会在初始化实现后进行），两种初始化形式依据本人业务状况二选一
//首次初始化会从.json或.geojson文件中读取边界图形数据，速度比较慢，会主动生成.wkbs结尾的结构化文件，下次初始化就很快了
AreaCityQuery.Init_StoreInWkbsFile("geojson文件门路", "geojson文件门路.wkbs", true);
//AreaCityQuery.Init_StoreInMemory("geojson文件门路", "geojson文件门路.wkbs", true);

//AreaCityQuery.OnInitProgress=(initInfo)->{ ... } //初始化过程中的回调，能够绑定一个函数，接管初始化进度信息

//查问蕴含一个坐标点的所有边界图形的属性数据，可通过res参数让查问额定返回wkt格局边界数据
QueryResult res1=AreaCityQuery.QueryPoint(114.044346, 22.691963, null, null);

//查问和一个图形（点、线、面）有交点的所有边界图形的属性数据，可通过res参数让查问额定返回wkt格局边界数据
Geometry geom=new WKTReader(AreaCityQuery.Factory).read("LINESTRING(114.233963 30.546038, 114.468109 30.544264)");
QueryResult res2=AreaCityQuery.QueryGeometry(geom, null, null);

//读取省市区的边界数据wkt格局，这个例子会筛选出武汉市所有区县
QueryResult res3=AreaCityQuery.ReadWKT_FromWkbsFile("wkt_polygon", null, (prop)->{return prop.contains("武汉市 ");}, null);


System.out.println(res1+"\n"+res2+"\n"+res3);

【END】