高德地图-行政区域 Rest API

提供行政区域查询 Rest 服务，定时同步高德地图开放平台提供的行政区域数据，保存到本地数据库，双表备份，保证同步期间不间断本地服务。

依赖

• Vert.x
• Netty
• Log4j2

部署用法

1 - 本项目使用 H2 数据库，默认已经有一个可用数据库文件

/src/resources/district.h2.db

打包后会存放在 conf/ 目录下

2 - 修改配置文件

/src/main/resources/app.json

api.param 中的 key 修改成自己在高德地图开放平台中申请的 key

url 配置 h2 数据库的路径，例如打包后放在 D 盘根目录，则配置成 jdbc:h2:D:/district/conf/district;MV_STORE=FALSE;MVCC=FALSE

通常配置完上面内容就可以打包运行了，下面给出其他配置说明：

http.port 配置服务监听端口
job.period 定时同步时间间隔，单位毫秒(ms)
api.host 高德地图api域名
api.port 高德地图api端口
api.uri 高德地图api资源路径
api.param 高德地图api参数
user h2数据库默认用户名
password h2数据库密码
maxPoolSize 数据库链接池最大链接数

3 - cd 到项目目录，执行打包命令

gradlew installDist

成功打包会在当前目录生成 ./build/install/district/

目录结构说明：

• district/bin/ 可执行脚本目录
• district/conf/ 配置文件目录
• district/lib/ 依赖库文件(jar)目录
• district/logs/ 日志文件目录

4 - 进入 ./build/install/district/bin/ Windows系统双击或者CMD下运行

district.bat

Linux系统调试时执行

./district

Linux系统后台运行时执行

nohup ./district&

5 - 访问 Rest 服务 查询某地行政区域：

http://yourip:port/district/api/index?code=110100

• port 默认8090，如果是本机调试可以访问 http://localhost:8090/district/api/index?code=110100
• code 参数是上级区划编码，如果不传默认是返回全国所有省、直辖市和自治区
• JSON返回值，以北京城区(110100)为上级查询为例：

{
  "result" : [ {
    "adcode" : "110101",
    "name" : "东城区"
  }, {
    "adcode" : "110102",
    "name" : "西城区"
  }, {
    "adcode" : "110105",
    "name" : "朝阳区"
  }, {
    "adcode" : "110106",
    "name" : "丰台区"
  }, {
    "adcode" : "110107",
    "name" : "石景山区"
  }, {
    "adcode" : "110108",
    "name" : "海淀区"
  }, {
    "adcode" : "110109",
    "name" : "门头沟区"
  }, {
    "adcode" : "110111",
    "name" : "房山区"
  }, {
    "adcode" : "110112",
    "name" : "通州区"
  }, {
    "adcode" : "110113",
    "name" : "顺义区"
  }, {
    "adcode" : "110114",
    "name" : "昌平区"
  }, {
    "adcode" : "110115",
    "name" : "大兴区"
  }, {
    "adcode" : "110116",
    "name" : "怀柔区"
  }, {
    "adcode" : "110117",
    "name" : "平谷区"
  }, {
    "adcode" : "110118",
    "name" : "密云区"
  }, {
    "adcode" : "110119",
    "name" : "延庆区"
  } ]
}

6 - 手动同步地址

http://yourip:port/district/api/update

访问这个地址会立即从高德地图开放平台同步最新行政区域数据到本地数据库