🗺 省份数据开放 API

把中国省级行政区地图与省级经济数据接入你的应用:地图 SVG 轮廓与标注坐标,以及各省 GDP、人均 GDP、常住人口、户籍人口、出生率、死亡率、自然增长率与历史序列。

2025最新数据年份

31覆盖省级区划

34地图轮廓数

1000次/日(额度)

① 开通省份数据 API 仅注册用户 · 支付后立即发放 Key

本服务为付费服务,且仅限注册用户开通。请先登录(或注册),登录后在本页在线支付,支付成功立即获得专属 API Key。

② 调用方式

在请求头携带 X-API-Key(推荐),或加查询参数 ?key=***。返回统一为 JSON:{"ok":true,"code":200,"data":{...}}

curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/map/overview"

响应头会返回当日配额:X-Quota-Limit / X-Quota-Used。超限返回 429,Key 无效返回 401,未开通/到期返回 403。

③ 接口列表全部为 GET · 本服务 ¥699/年

GET/api/ow/map/overview

数据概览:各表最新年份、覆盖省份数、指标字段清单与可排序项。

curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/map/overview"

GET/api/ow/map/provinces

全部省级区划及指标(GDP / 人均 GDP / 常住人口 / 户籍人口 / 出生率 / 死亡率 / 自然增长率)。

参数	必填	说明
year	否	如 2025,默认各表最新

curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/map/provinces?year=2025"

GET/api/ow/map/detail

单个省级区划的指标。

参数	必填	说明
code	是	省级区划码,如 440000(广东)

curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/map/detail?code=***"

GET/api/ow/map/history

单个省份的历史序列(GDP / 人均 GDP)。

参数	必填	说明
code	是	省级区划码
from / to	否	年份范围,如 from=2015

curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/map/history?code=***&from=2015"

GET/api/ow/map/ranking

省级排行(可按 GDP / 人均 / 常住人口 / 户籍人口 / 出生率 / 死亡率 / 自然增长率排序)。

参数	必填	说明
sort	否	gdp(默认)/ gdp_per / pop / hjpop / birth / death / growth
year	否	默认最新
limit	否	最大 100,默认 34

curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/map/ranking?sort=gdp&limit=10"

GET/api/ow/map/geo

地图数据:各省 SVG 路径轮廓 + 标注坐标(textPosition),可直接用于前端绘制中国地图。

curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/map/geo"

④ 返回示例

{ "ok": true, "code": 200, "data": { "code": "440000", "name": "广东省", "year": 2025, "gdp": 145846.76, "gdp_per": 113769, "pop": 12684, "hjpop": 10000, "birth": 8.3, "death": 4.9, "growth": 3.4 } }

字段说明:gdp GDP(亿元) · gdp_per 人均 GDP(元) · pop 常住人口(万人) · hjpop 户籍人口(万人) · birth 出生率(‰) · death 死亡率(‰) · growth 自然增长率(‰)。
错误码:401 Key 缺失/无效 · 403 Key 未开通/已停用/已到期 · 404 未找到数据 · 429 超出当日配额 · 422 参数错误。

⑤ 使用条款

1. 数据整理自公开渠道,仅供研究与产品展示参考,不构成投资建议;
2. 请注明数据来源“鸥维数据(www.oweidata.com)”;
3. 禁止转售、二次分发原始数据或进行高频爬取;
4. 本服务含 1000 次/日调用额度;如需更高配额或商用授权,请通过页脚「关于我们」联系我们。