Skip to content

Commit

Permalink
更新文档
Browse files Browse the repository at this point in the history
  • Loading branch information
xiangyuecn committed Jul 31, 2022
1 parent 1a7a158 commit 4121d5f
Show file tree
Hide file tree
Showing 9 changed files with 401 additions and 135 deletions.
14 changes: 12 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
- [【在线测试和预览】省市区镇四级行政区划数据](https://xiangyuecn.gitee.io/areacity-jsspider-statsgov/):支持在线生成JSON、多级联动js;
- [【在线测试和预览】ECharts Map四级下钻在线测试和预览+代码生成](https://xiangyuecn.gitee.io/areacity-jsspider-statsgov/assets/geo-echarts.html):坐标边界范围在线测试和预览;
- [【转换工具】AreaCity-Geo格式转换工具软件](https://xiangyuecn.gitee.io/areacity-jsspider-statsgov/assets/AreaCity-Geo-Transform-Tools.html):csv文件导入数据库,坐标、边界范围转换(支持转成`sql``shp``geojson`);
- [【查询工具】AreaCity-Query-Geometry](https://github.com/xiangyuecn/AreaCity-Query-Geometry):高性能的坐标数据、边界数据查询工具,Java开源程序、带http查询接口,内存占用低。
- [【查询工具】AreaCity-Query-Geometry](https://github.com/xiangyuecn/AreaCity-Query-Geometry)[Gitee镜像库](https://gitee.com/xiangyuecn/AreaCity-Query-Geometry):高性能的坐标数据、边界数据查询工具,Java开源程序、带http查询接口,内存占用低。


## 数据下载
Expand All @@ -25,9 +25,19 @@
> 通过本库提供的 [AreaCity-Geo格式转换工具](https://xiangyuecn.gitee.io/areacity-jsspider-statsgov/assets/AreaCity-Geo-Transform-Tools.html) 可快速方便的将省市区、坐标、边界范围csv文件导入数据库,并且提供格式转换功能(shp、geojson、sql),欢迎下载使用。边界导出成geojson后可通过 [AreaCity-Query-Geometry](https://github.com/xiangyuecn/AreaCity-Query-Geometry) Java开源程序进行高性能的坐标数据、边界数据查询。

[](?)

**如需数据、功能定制,网站、App、小程序、前端后端开发等需求;矢量专题地图绘制、修改,前端地图、大屏、ECharts数据展示开发,后端数据处理、接口开发;请加本文档下面的QQ群,联系群主(即作者),谢谢~**




[](?)

[](?)

[](?)

[](?)

[](?)
Expand Down Expand Up @@ -263,7 +273,7 @@ ECharts + 高德地图四级下钻:


# :open_book:坐标边界查询工具 - AreaCity-Query-Geometry
[AreaCity-Query-Geometry](https://github.com/xiangyuecn/AreaCity-Query-Geometry) 是一个高性能的坐标数据、边界数据查询工具,Java开源程序、带http查询接口,内存占用低,比数据库查询快几百倍;先用上面的格式转换工具将ok_geo.csv转成geojson格式,然后运行此工具即可测试使用。
[AreaCity-Query-Geometry](https://github.com/xiangyuecn/AreaCity-Query-Geometry) [Gitee镜像库](https://gitee.com/xiangyuecn/AreaCity-Query-Geometry)是一个高性能的坐标数据、边界数据查询工具,Java开源程序、带http查询接口,内存占用低,比数据库查询快几百倍;先用上面的格式转换工具将ok_geo.csv转成geojson格式,然后运行此工具即可测试使用。

## 工具支持:
- 查询一个坐标点对应的城市信息;
Expand Down
17 changes: 16 additions & 1 deletion assets/AreaCity-Geo-Transform-Tools.html
Original file line number Diff line number Diff line change
Expand Up @@ -203,6 +203,7 @@
<li>自动校验坐标和边界矢量数据的有效性。</li>
<li>可执行自定义 JavaScript 脚本,可扩展出丰富功能。</li>
<li>转换精度高,速度快,内存占用小,3-5分钟左右可转换完所有数据。</li>
<li>配套提供坐标数据、边界数据查询工具:<a href="https://github.com/xiangyuecn/AreaCity-Query-Geometry" target="_blank">AreaCity-Query-Geometry</a>开源库(<a href="https://gitee.com/xiangyuecn/AreaCity-Query-Geometry" target="_blank">Gitee镜像库</a>),支持Java调用或HTTP API接口调用,内存占用低,1秒可查1万个以上坐标对应的城市信息。</li>
<li>支持Win10、Win8、Win7,32位、64位系统使用(其他系统装虚拟机可用)。</li>
</ul>
</div>
Expand Down Expand Up @@ -447,6 +448,12 @@
</div>
</div>

<div style="margin-top:8px;color:#0b1;font-size:13px;word-break: break-all;">
查询性能:数据库查询一个坐标对应的城市性能一般比较低,可以使用 AreaCity-Query-Geometry 开源库,支持Java调用或HTTP API接口调用,内存占用低,1秒可查1万个以上坐标对应的城市信息。

详细请阅读<a href="#aqg">FAQ</a>
</div>

<div style="margin-top:8px;color:#f60;font-size:13px;word-break: break-all;">注意:MySQL 5.* 中进行空间计算查询时,不带ST_打头的函数均为采用Polygon的外接矩形计算,会导致结果不准确,应当使用带ST_打头的方法来进行查询。

MySQL的空间索引很难生效 <a href="https://dev.mysql.com/doc/refman/8.0/en/spatial-index-optimization.html" target="_blank">官方文档</a>,从而导致空间查询异常缓慢,可通过增加一个字段: polygon_envelope=ST_Envelope(polygon) 来自建索引,查询的时候先查 polygon_envelope ,然后再查 polygon 字段,速度就会快很多(10倍+),也可同时切换成MyISAM引擎,会比InnoDB引擎的空间查询快很多。
Expand Down Expand Up @@ -763,9 +770,17 @@
and ST_Intersects(polygon,ST_GeomFromText('POINT(114.044346 22.691963)',0))=1</i>;也可同时切换成MyISAM引擎,会比InnoDB引擎的空间查询快很多。</p>
</div>

<div class="h3">高性能:如何做到1秒查询1万个以上坐标对应的城市信息?<a name="aqg"></a></div>
<div class="desc">
<p>使用配套提供的坐标数据、边界数据查询工具:<a href="https://github.com/xiangyuecn/AreaCity-Query-Geometry" target="_blank">AreaCity-Query-Geometry</a>开源库(<a href="https://gitee.com/xiangyuecn/AreaCity-Query-Geometry" target="_blank">Gitee镜像库</a>),支持Java调用或HTTP API接口调用,内存占用低,1秒可查1万个以上坐标对应的城市信息。</p>

<p>使用方法:先使用转换工具将 ok_geo.csv 转换成 geojson格式;然后打开查询工具并使用此geojson文件进行初始化,然后根据菜单启动HTTP API服务,就能调用API进行查询了;或者直接编写Java代码,代码中使用此geojson文件进行初始化,然后调用对应的查询方法进行查询。</p>
</div>

<div class="h3">如何在QQ群内下载本工具?<a name="xzqq"></a></div>
<div class="desc">
加入QQ群:①群 <i class="i">484560085</i>、②群 <i class="i">626141661</i>,口令<i class="i">areacity</i>,然后到群文件中下载。
加入QQ群:<span class="qqGroupList"></span>,然后到群文件中下载。
<script>QQGroupList.HTML_i(".qqGroupList")</script>
</div>

<div class="h3">Mac OS等非Windows系统上如何使用本工具?<a name="otherSys"></a></div>
Expand Down
26 changes: 25 additions & 1 deletion assets/csv-ver-date.js
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ var CsvPubDate=window.CsvPubDate={

,Geo4:{
name:"乡镇第4级坐标边界数据"
,desc:'['+Url("下载",UrlRoot+"assets/geo-level4.html")+']['+Url("在线预览",UrlEcharts)+'][<span style="color:#fa0">付费数据</span>] 文件大小:90MB+压缩包,导出后300M+;包含字段:矢量边界polygon、中心坐标centroid_geo、编号id、上级区县pid、乡镇名称name;'+GeoTips+'。本数据源自:第三方购买 + 公开数据源整合;部分省份由于没有最新的数据源,但上级区县变更往往会囊括原有的乡镇,乡镇边界一般少有大的变化,所以乡镇边界与压缩包内最新版的省市区行政区划、边界均可进行关联匹配。下表中的省份年月为一个大概的值(不一定准确),仅用于参考。'
,desc:'['+Url("下载",UrlRoot+"assets/geo-level4.html#xz")+']['+Url("在线预览",UrlEcharts)+'][<span style="color:#fa0">付费数据</span>]['+Url("文档",UrlRoot+"assets/geo-level4.html")+'] 文件大小:90MB+压缩包,导出后300M+;包含字段:矢量边界polygon、中心坐标centroid_geo、编号id、上级区县pid、乡镇名称name;'+GeoTips+'。本数据源自:第三方购买 + 公开数据源整合;部分省份由于没有最新的数据源,但上级区县变更往往会囊括原有的乡镇,乡镇边界一般少有大的变化,所以乡镇边界与压缩包内最新版的省市区行政区划、边界均可进行关联匹配。下表中的省份年月为一个大概的值(不一定准确),仅用于参考。'
,file:"ok_geo4_ETD220408.csv"
,version:"ETD220408"
,dates:{//年-月 A排序年.月
Expand Down Expand Up @@ -187,4 +187,28 @@ if(set.geo4){
};






window.QQGroupList={
List:[{name:"①群",qq:"484560085"},{name:"②群",qq:"626141661"}]
,HTML_i:function(cls){
var html=[];
for(var i=0;i<this.List.length;i++){
var o=this.List[i];
html.push(o.name+' <i class="i">'+o.qq+'</i>');
}
html=html.join("、")+',口令<i class="i">areacity</i>';
if(cls){
document.querySelector(cls).innerHTML=html;
}
return html;
}
};





})();
13 changes: 9 additions & 4 deletions assets/download.html
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,8 @@

<div class="mainBox downArea" downkey="level3">
<div class="mainCodeBtn">
<a class="downBtn mainBtn">【免费开源】【三级】省市区 行政区划 数据下载</a>
【免费开源】【三级】省市区 行政区划 数据
<a class="downBtn mainBtn">下载</a>
<span class="downTips">
文件路径:<span class="downPath"></span>
(200KB+)
Expand All @@ -98,7 +99,8 @@

<div class="mainBox downArea" downkey="level4">
<div class="mainCodeBtn">
<a class="downBtn mainBtn">【免费开源】【四级】省市区镇 行政区划 数据下载</a>
【免费开源】【四级】省市区镇 行政区划 数据
<a class="downBtn mainBtn">下载</a>
<span class="downTips">
文件路径:<span class="downPath"></span>
(3MB+)
Expand All @@ -108,7 +110,8 @@

<div class="mainBox downArea" downkey="geo">
<div class="mainCodeBtn">
<a class="downBtn mainBtn">【免费开源】【GEO三级】省市区 坐标和边界 数据下载</a>
【免费开源】【GEO三级】省市区 坐标和边界 数据
<a class="downBtn mainBtn">下载</a>
<span class="downTips">
文件路径:<span class="downPath"></span>
(13MB+压缩包 解压后130M+)
Expand All @@ -118,7 +121,8 @@

<div class="mainBox">
<div class="mainCodeBtn">
<a class="mainBtn Btn_Yellow" href="https://xiangyuecn.gitee.io/areacity-jsspider-statsgov/assets/geo-level4.html">【付费数据】【GEO四级】乡镇 坐标和边界 数据下载</a>
<span style="color:#fa0">【付费数据】【GEO四级】乡镇 坐标和边界 数据</span>
<a class="mainBtn Btn_Yellow" href="https://xiangyuecn.gitee.io/areacity-jsspider-statsgov/assets/geo-level4.html">下载</a>
<span class="downTips">
<span style="color:#fa0">乡镇第4级坐标边界数据 ok_geo4_*.csv,</span>
(90MB+压缩包 导出后300M+)
Expand Down Expand Up @@ -164,6 +168,7 @@
mainLog("发现"+file,2);
};

mainLog('高性能:如何做到1秒查询1万个以上坐标对应的城市信息?使用配套提供的坐标数据、边界数据查询工具:<a href="https://github.com/xiangyuecn/AreaCity-Query-Geometry" target="_blank">AreaCity-Query-Geometry</a>开源库(<a href="https://gitee.com/xiangyuecn/AreaCity-Query-Geometry" target="_blank">Gitee镜像库</a>),支持Java调用或HTTP API接口调用,内存占用低,1秒可查1万个以上坐标对应的城市信息',"#000;font-weight:bold;font-size:24px");
mainLog('坐标和边界数据为csv格式,需自行解析提取。或者使用《<a href="AreaCity-Geo-Transform-Tools.html" target="_blank">AreaCity-Geo格式转换工具软件</a>》快速的转换成shp、geojson、sql、导入数据库、转换坐标系,本工具也支持将行政区划数据导入数据库',"#f60;font-weight:bold;font-size:24px");
mainLog('点击上方下载按钮即可下载csv格式数据,行政区划数据如果需要其他格式,<a href="../" target="_blank">可点此在线转换</a>',"#0b1;font-weight:bold;font-size:24px");
mainLog('GitHub Releases中提供的下载连接可能下载缓慢,因此提供本Gitee Pages外链下载,速度会快很多~');
Expand Down
4 changes: 2 additions & 2 deletions assets/geo-echarts-aqg-tools.js
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ var pointQuery=function(url,args){
url+="?lng="+lng+"&lat="+lat+"&returnWKTKey=polygon";
var t1=Date.now();
geoEChartsLib.Post(url,{},function(data){
mapPointAdd(new AMap.Marker({ position: [lng,lat] }));
mapPointAdd("查询坐标点",lng,lat);
addFeatures(Date.now()-t1,data);
},function(err){
log(err,1);
Expand All @@ -126,7 +126,7 @@ var extPathQuery=function(url,args){

var Features=[],QueryID=0;
var clearFeatures=function(){
mapPointReview(true);
mapPointClear();
Features=[];
};
var addFeatures=function(loadMs,data){
Expand Down
Loading

0 comments on commit 4121d5f

Please sign in to comment.