5 Star 32 Fork 13

simple / AMapPoi

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

POIKit

build Maintenance version

POIKit 目的是提供一套简单易用且稳定的 POI 获取与处理工具套件,方便 GIS 相关从业者。目前软件处于初步构建状态,希望各位多多尝试,多多提问题(The More Questions,The Better)。

目录

Preview

preview

功能演示

POI 搜索功能

以行政区为例。POI 类型:餐饮服务;行政区:371723;初始网格数:4;阈值:850;线程数目:2;输出格式:csv,POI 搜索功能如下所示:

POI搜索

功能配置参数如下表:

参数 说明 注意
高德 key 软件支持多个 key,不同 key 之间需要用逗号分割 注意,只能使用英文逗号,且不能包含换行符、空格等
开发者类型 个人开发者或个人认证开发者或企业开发者 用于设置 QPS 值,当用户设置线程数大于最大线程数,将强制设为最大线程,防止过高并发
POI 关键字 搜索关键字,如KFC,不同关键字之间使用逗号分割 只能使用英文逗号 分割
POI 类型 搜索类型,可为分类代码或汉字,如 010000,不同类型之间使用逗号分割 只能使用英文逗号分割,若使用汉字,必须严格按照高德 POI 分类编码中的汉字编写
行政区 行政区六位代码 -
矩形 格式严格遵循左上角经纬度#右下角经纬度,如133,34#135,30 经纬度坐标可以使用wgs84/gcj02/bd09 坐标,请使用下拉框选择合适的经纬度坐标
自定义 支持用户上传 geojson 边界文件 经纬度坐标可以使用wgs84/gcj02/bd09 坐标,类型可以为PolygonMultiPolygon
初始网格数 初始网格剖分数目 一般情况按默认值为 4 即可
阈值 当该网格 POI 数量超出阈值,会对网格进一步四分 一般情况下按 850 即可
线程数目 线程数量一般不大于 QPS * keys_num,个人开发者最多设为 20,个人认证开发者最多设为 50,网速较快时也应降低 QPS 可以在流量限制说明查看
输出格式 目前支持 geojson、shp、csv、txt 结果包含 gcj02 和 wgs84 两种坐标,若输出格式为 geojson 或 shp,使用 wgs84 坐标

注意:

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

  2. 若爬取过程中,用户点击取消,软件会停止爬取,不会导出。

输出参数说明:

参数 说明
name 名称
type 兴趣点类型
typecode 兴趣点类型编码
address 地址
pname POI 所在省份名称
cityname 城市名
adname 区域名称
gcj02_lon gcj02 经度
gcj02_lat gcj02 纬度
wgs84_lon wgs84 经度
wgs84_lat wgs84 纬度

地理编码功能

地理编码

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

参数 说明 注意
高德 key 软件支持多个 key,不同 key 之间需要用逗号分割 注意,只能使用英文逗号,且不能包含换行符、空格等
开发者类型 个人开发者或个人认证开发者或企业开发者 用于设置 QPS 值,当用户设置线程数大于最大线程数,将强制设为最大线程,防止过高并发
线程数目 线程数量一般不大于 QPS * keys_num QPS 可以在流量限制说明查看
输入文件 支持 csv 或 txt 格式文件 至少需要包含address字段
输出目录 结果输出路径,目前地理编码结果包括 gcj02 和 wgs84 两种坐标 -

注意:

  1. 若地理编码过程中 key 池额度用尽,软件会停止地理编码,但不会删除之前得到的数据,仍会导出。
  2. 若地理编码过程中,用户点击取消,软件会停止地理编码,不会导出。

输出参数说明:

参数 说明
formatted_address 结构化地址信息
country 国家
province 地址所在的省份名
city 地址所在的省份名
citycode 城市编码
district 地址所在的区
adcode 区域编码
street 街道
number 门牌
level 匹配级别
gcj02_lon gcj02 经度
gcj02_lat gcj02 纬度
wgs84_lon wgs84 经度
wgs84_lat wgs84 纬度

格式转换

地理编码

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

参数 说明
输入文件 支持 geojson 或 shp 格式文件
输出格式 若选择 geojson,则可以输出 shp,若选择 shp,则可以输出 geojson 或 csv
输出目录 结果输出路径

坐标转换

坐标转换

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

参数 说明
输入文件 支持 geojson 或 shp 格式文件
输入坐标格式 即输入文件的坐标格式,wgs84/gcj02/bd09
输出目录 结果输出路径
输入坐标格式 即输出文件的坐标格式,wgs84/gcj02/bd09

安装

  1. 软件基于 Java 环境运行,需要首先安装 jre/jdk(1.8 版本),安装步骤如下:
    • 下载JDK8,选择适合本系统的版本;
    • 配置环境变量JAVA_HOME为安装目录,然后在Path中添加%JAVA_HOME%\bin
    • 打开终端,输入java -version,若出现 Java 版本号,则配置成功。
  2. 下载最新发布的软件压缩包,以POIKit.zip为例,解压缩后,双击start.bat即可运行。

技术选型

目前软件采用 MVC 软件架构模式,技术选型如下:

维护人员

@Civitasv

@SkyTreeDelivery

支持该项目

若遇到任何问题,你可以通过以下方式联系我:

  1. 邮箱:sen.hu@whu.edu.cn,我会定时查看邮箱,但不保证实时性;
  2. 用户 QQ 群:1097532420
  3. issue:这是我推荐的方式,有问题时,也应该首先查看 issue 列表是否已有该问题的解答;

若帮助到了您,Github Star 是对我最大的肯定。

开发路线

  • v0.0.1 2021-04-20

    • 初步实现软件及安装文档;
  • v0.0.2 2021-04-22

    • 修复重复 bug;
  • v0.0.3 2021-04-23

    • 线程池运行优化;
    • 添加运行状态提示
  • v0.0.4-alpha 2021-04-23

    • 添加 POI 检索错误码输出;
    • 修改地理编码返回字段;
    • 添加开发者类型选择下拉框,防止过高并发;
    • 解决点击“执行按钮”卡顿 bug;
    • 【重要更新】POI 搜索添加导出 shp 功能
  • v0.0.4 2021-04-26

    • 添加选取坐标类型(gcj02/wgs84)功能
    • 初步完成 geojson 转 shp,shp 转 geojson,shp 转 csv
    • 添加 cpg 格式文件,防止乱码
    • 若干 bug 修复
  • v0.05 2021-04-27

    • 行政区、用户自定义文件爬取得到的 POI 不再是其外接矩形的 POI,即用户不需要再做裁切处理;
    • 完成坐标转换工具开发,进行 wgs84、gcj02 和 bd09 坐标之间的转换,文件格式支持 geojson/shp,其中 geojson 支持 Point、MultiPoint、LineString、MultiLineString、Polygon 和 MultiPolygon,不支持 GeometryCollection;
    • 使用不同的线程控制机制,能够增加线程数目,更加快速的获取 POI
    • UI bug 修复、cpg 文件生成修复等。

License

MIT © Civitasv

MIT License Copyright (c) [year] [fullname] Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

POI搜索工具、地理编码工具 展开 收起
Java 等 2 种语言
MIT
取消

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/simpls/AMapPoi.git
git@gitee.com:simpls/AMapPoi.git
simpls
AMapPoi
AMapPoi
master

搜索帮助