Skip to content
This repository has been archived by the owner on Jun 4, 2024. It is now read-only.

Commit

Permalink
更新README
Browse files Browse the repository at this point in the history
  • Loading branch information
Civitasv committed Apr 23, 2021
1 parent 9f36dc0 commit 3fe60c9
Show file tree
Hide file tree
Showing 6 changed files with 32 additions and 38 deletions.
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,5 @@
src/test
geospider.iml
target
out
out
latest
67 changes: 30 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,30 +34,25 @@ POIKit 目的是提供一套简单易用且稳定的 POI 获取与处理工具

| 参数 | 说明 | 注意 |
| :--------: | :---------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------: |
| 高德 key | 软件支持多个 key,不同 key 之间需要用逗号分割 | 注意,只能使用**
英文逗号**,且不能包含换行符、空格等 |
| POI 关键字 | 搜索关键字,如**
KFC**,不同关键字之间使用逗号分割 | 只能使用**
英文逗号** |
| 高德 key | 软件支持多个 key,不同 key 之间需要用逗号分割 | 注意,只能使用**英文逗号**,且不能包含换行符、空格等 |
| 开发者类型 | 个人开发者或个人认证开发者或企业开发者 | 用于设置 QPS 值,当用户设置线程数大于最大线程数,将强制设为最大线程,防止过高并发 |
| POI 关键字 | 搜索关键字,如**KFC**,不同关键字之间使用逗号分割 | 只能使用**英文逗号** 分割 |
| POI 类型 | 搜索类型,可为分类代码或汉字 | 若使用汉字,必须严格按照[高德 POI 分类编码](https://lbs.amap.com/api/webservice/download)中的汉字编写 |
| 行政区 | [行政区六位代码](http://www.mca.gov.cn//article/sj/xzqh/2020/202006/202008310601.shtml) | - |
| 矩形 | 格式严格遵循左上角经纬度#右下角经纬度,如**
133,34#135,30** | 经纬度坐标需要使用**GCJ02 坐标**,只能使用**
英文逗号** |
| 自定义 | 支持用户上传 geojson 边界文件 | 经纬度坐标需要使用**
GCJ02 坐标**,类型必须为**MultiPolygon** |
| 矩形 | 格式严格遵循左上角经纬度#右下角经纬度,如**133,34#135,30** | 经纬度坐标需要使用**GCJ02 坐标**,只能使用**英文逗号** |
| 自定义 | 支持用户上传 geojson 边界文件 | 经纬度坐标需要使用**GCJ02 坐标**,类型必须为**MultiPolygon** |
| 初始网格数 | 初始网格剖分数目 | 一般情况按默认值为 4 即可 |
| 阈值 | 当该网格 POI 数量超出阈值,会对网格进一步四分 | 一般情况下按 850 即可 |
| 线程数目 | 线程数量一般不大于 QPS - keys_num - 0.1,个人开发者最多设为 2,个人认证开发者最多设为 5,网速较快时也应降低 | QPS 可以在[流量限制说明](https://lbs.amap.com/api/webservice/guide/tools/flowlevel)查看 |
| 输出格式 | 目前支持 geojson、shp、csv、txt | 结果包含 gcj02 和 wgs84 两种坐标,若输出格式为 geojson,使用 wgs84 坐标 |
| 输出格式 | 目前支持 geojson、**shp**、csv、txt | 结果包含 gcj02 和 wgs84 两种坐标,若输出格式为 geojson 或 shp,使用 wgs84 坐标 |

**注意:**

**行政区、矩形和用户自定义文件爬取结果为该区域的外接矩形的 POI,因此,除矩形区域检索外,其它方式均需要使用 ArcGIS 裁切工具将区域外的 POI 进行筛除!**
1. **行政区、矩形和用户自定义文件爬取结果为该区域的外接矩形的 POI,因此,除矩形区域检索外,其它方式均需要使用 ArcGIS 裁切工具将区域外的 POI 进行筛除!**

**若爬取过程中 key 池额度用尽,软件会停止爬取,但不会删除之前爬取得到的数据,仍会导出。**
2. **若爬取过程中 key 池额度用尽,软件会停止爬取,但不会删除之前爬取得到的数据,仍会导出。**

**若爬取过程中,用户点击取消,软件会停止爬取,但不会删除之前爬取得到的数据,仍会导出。**
3. **若爬取过程中,用户点击取消,软件会停止爬取,但不会删除之前爬取得到的数据,仍会导出。**

**输出参数说明:**

Expand Down Expand Up @@ -93,14 +88,13 @@ city,address

**功能配置参数如下表所示:**

| 参数 | 说明 | 注意 |
| :------: | :-----------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: |
| 高德 key | 软件支持多个 key,不同 key 之间需要用逗号分割 | 注意,只能使用**
英文逗号**,且不能包含换行符、空格等 |
| 线程数目 | 线程数量一般不大于 QPS - keys_num - 0.1,个人开发者最多设为 2,个人认证开发者最多设为 5,网速较快时也应降低线程数目 | [QPS 可以在流量限制说明查看](https://lbs.amap.com/api/webservice/guide/tools/flowlevel) |
| 输入文件 | 支持 csv 或 txt 格式文件 | 至少需要包含**
address**字段 |
| 输出目录 | 结果输出路径,目前地理编码结果包括 gcj02 和 wgs84 两种坐标 | - |
| 参数 | 说明 | 注意 |
| :--------: | :-----------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------: |
| 高德 key | 软件支持多个 key,不同 key 之间需要用逗号分割 | 注意,只能使用**英文逗号**,且不能包含换行符、空格等 |
| 开发者类型 | 个人开发者或个人认证开发者或企业开发者 | 用于设置 QPS 值,当用户设置线程数大于最大线程数,将强制设为最大线程,防止过高并发 |
| 线程数目 | 线程数量一般不大于 QPS - keys_num - 0.1,个人开发者最多设为 2,个人认证开发者最多设为 5,网速较快时也应降低线程数目 | [QPS 可以在流量限制说明查看](https://lbs.amap.com/api/webservice/guide/tools/flowlevel) |
| 输入文件 | 支持 csv 或 txt 格式文件 | 至少需要包含**address**字段 |
| 输出目录 | 结果输出路径,目前地理编码结果包括 gcj02 和 wgs84 两种坐标 | - |

**注意:**

Expand Down Expand Up @@ -128,11 +122,10 @@ address**字段 |
## 安装

1. 软件基于 Java 环境运行,需要首先安装 jre/jdk(1.8 版本),安装步骤如下:
- 下载[JDK8](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html),选择适合本系统的版本;
- 配置环境变量`JAVA_HOME`为安装目录,然后在`Path`中添加`%JAVA_HOME%\bin`
- 打开终端,输入`java -version`,若出现 Java 版本号,则配置成功。
2. [下载](https://github.com/Civitasv/AMapPoi/releases/latest)最新发布的软件压缩包,以`geospider.zip`为例,解压缩后,双击`geospider.jar`即可使用 jre
运行,若不能直接运行,在该文件夹打开`cmd`,输入`java -jar geospider.jar`即可运行。
- 下载[JDK8](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html),选择适合本系统的版本;
- 配置环境变量`JAVA_HOME`为安装目录,然后在`Path`中添加`%JAVA_HOME%\bin`
- 打开终端,输入`java -version`,若出现 Java 版本号,则配置成功。
2. [下载](https://github.com/Civitasv/AMapPoi/releases/latest)最新发布的软件压缩包,以`POIKit.zip`为例,解压缩后,双击`start.bat`即可运行。

## 技术选型

Expand All @@ -159,18 +152,18 @@ address**字段 |
## 开发路线

- **v0.0.1** 2021-04-20
- 初步实现软件及安装文档;
- 初步实现软件及安装文档;
- **v0.0.2** 2021-04-22
- 修复重复 bug;
- 修复重复 bug;
- **v0.0.3** 2021-04-23
- 线程池运行优化;
- 添加运行状态提示
- **v0.0.4** 2021-04-23
-POI搜索】添加shp导出功能
- 添加POI检索[错误码](https://lbs.amap.com/api/webservice/guide/tools/info)说明;
- 修改地理编码返回字段;
- 添加开发者类型选择;
- 解决点击“执行按钮”卡顿bug
- 线程池运行优化;
- 添加运行状态提示
- **v0.0.4-alpha** 2021-04-23
-POI 搜索】添加 shp 导出功能
- 添加 POI 检索[错误码](https://lbs.amap.com/api/webservice/guide/tools/info)说明;
- 修改地理编码返回字段;
- 添加开发者类型选择;
- 解决点击“执行按钮”卡顿 bug

## License

Expand Down
Binary file modified image/geocoding.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed image/geocoding.png
Binary file not shown.
Binary file modified image/poi.gif
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed image/poi.png
Binary file not shown.

0 comments on commit 3fe60c9

Please sign in to comment.