1. 介紹
該服務(wù)提供國家省市區(qū)/縣數(shù)據(jù)接口兽叮；
支持代碼本地部署&docker部署;
支持數(shù)據(jù)自更新挑围；
2. 接口調(diào)用
2.1 獲取省級數(shù)據(jù)
http://127.0.0.1:{port}
返回數(shù)據(jù)案例
[
{
"id": 1,
"code": "110000", // 城市編碼
"name": "北京市", // 城市名稱
"level": 1, // 級別殴玛，1省2市3區(qū)縣
"ccode": "010", // 城市電話區(qū)號
"center": "116.407394,39.904211", // 城市中心經(jīng)緯度
"parentid": -1 // 省級的父id是-1
},
...
]
2.2 獲取城市列表
http://127.0.0.1:7001?pid={pid}&level=2
2.3 獲取城市列表
http://127.0.0.1:7001?pid={pid}&level=3
3. 部署
3.1 常規(guī)部署
-
解壓 maike-area.zip； 目錄結(jié)構(gòu)如下
- dist/ // 服務(wù)相關(guān)文件 - bootstrap.js // 服務(wù)啟動入口 - areaConfig.txt // 省市區(qū)數(shù)據(jù)庫插入指令 - package.json -
在項目根目錄執(zhí)行指令
npm start // 服務(wù)默認監(jiān)聽7001端口; 可在package.json中配置 數(shù)據(jù)更改
項目啟動后會在dist同級創(chuàng)建一個config文件夾，里面生成一個area.db數(shù)據(jù)庫文件；為sqlite3庫沟启；用戶可自己創(chuàng)建鏈接并修改忆家。 需要注意的是： 因服務(wù)中有常駐數(shù)據(jù)緩存；修改數(shù)據(jù)庫后德迹，需要重新服務(wù)才會生效芽卿。
3.2 docker部署
- 拿到 maike-area-docker.tar文件后；執(zhí)行如下命令導(dǎo)入鏡像
docker load -i maike-area-docker.tar - 執(zhí)行如下命令生成docker實例
docker run -itd -p 7001:7001 --name area maike/area:1.0 - 如果有修改數(shù)據(jù)庫的需求胳搞，可以把數(shù)據(jù)庫映射出來
docker run -itd -p 7001:7001 --name area -v {pwd}/config:/app/config maike/area:1.0
3.3 docker-compose 部署
- 獲取 maike-area-docker.tar時卸例，會同步拿到 docker-compose.yml 文件；放到指定目錄后肌毅，打開文件修改對應(yīng)配置
version: '1' services: web: image: maike/area1.0 ports: - "7001:7001" volumes: - "./config:/app/config" restart: always container_name: 'area' - 執(zhí)行如下命令創(chuàng)建服務(wù)實例
docker-compose up
4. 獲取服務(wù)
留言聯(lián)系獲取
