接口目录 - 地图帮 GeoAPI 开放平台

地址解析

地址与经纬度互转，支持全国地址解析

2 个接口

地址解析

地理编码

能力标识：geocode

GET

地址 → 经纬度，支持全国地址解析

输入

地址：北京市朝阳区阜通东大街6号；城市：北京

输出

返回北京市 · 北京市 · 朝阳区的结构化地址信息，以及坐标 116.480881,39.989410。

调用路径：/api/v1/geocode

常用输入项

address city

在线调试购买额度

地址解析

逆地理编码

能力标识：regeocode

GET

经纬度 → 地址，支持全国坐标反查

输入

经纬度：116.480881,39.989410；半径：1000 米

输出

返回北京市 · 北京市 · 朝阳区 · 阜通东大街附近的地址、街道、门牌和周边信息。

调用路径：/api/v1/regeocode

常用输入项

location radius extensions

在线调试购买额度

路径规划

驾车、步行、骑行、公交多种出行方式路径规划

4 个接口

路径规划

驾车路径规划

能力标识：route/driving

GET

驾车路径规划

输入

起点：116.481028,39.989643；终点：116.434446,39.90816

输出

返回驾车路线方案，包括距离、预计耗时、分段道路和导航步骤。

调用路径：/api/v1/route/driving

常用输入项

origin destination extensions strategy waypoints avoidroad

在线调试购买额度

路径规划

步行路径规划

能力标识：route/walking

GET

步行路径规划

输入

起点：116.481028,39.989643；终点：116.434446,39.90816

输出

返回步行路线方案，包括步行距离、预计耗时和分段导航说明。

调用路径：/api/v1/route/walking

常用输入项

origin destination

在线调试购买额度

路径规划

骑行路径规划

能力标识：route/bicycling

GET

骑行路径规划

输入

起点：116.481028,39.989643；终点：116.434446,39.90816

输出

返回骑行路线方案，包括骑行距离、预计耗时和路线分段。

调用路径：/api/v1/route/bicycling

常用输入项

origin destination

在线调试购买额度

路径规划

公交路径规划

能力标识：route/transit

GET

公交路径规划

输入

起点：116.481028,39.989643；终点：116.434446,39.90816；城市：北京

输出

返回公交或地铁换乘方案，包括线路、站点、步行段、距离和预计耗时。

调用路径：/api/v1/route/transit

常用输入项

origin destination city cityd extensions strategy nightflag

在线调试购买额度

POI 检索

POI 关键词、区域检索

2 个接口

POI 检索

POI 圆形区域检索

能力标识：poi/circle

GET

POI 圆形区域检索

输入

关键词：美食；圆心：39.915,116.404；半径：1000 米

输出

返回圆形范围内的美食 POI 列表，适合做附近搜索、周边设施分析。

调用路径：/api/v1/poi/circle

常用输入项

query location radius tag page_num page_size

在线调试购买额度

POI 检索

POI 多边形区域检索

能力标识：poi/polygon

GET

POI 多边形区域检索

输入

多边形范围：湖州一块区域；关键词：美食；每页 50 条

输出

返回多边形范围内的 POI 列表，包含名称、地址、坐标、分类和商圈等信息。

调用路径：/api/v1/poi/polygon

常用输入项

polygon keywords types page offset extensions

在线调试购买额度

区域边界与行政区划

AOI 边界数据、行政区划查询

1 个接口

区域边界与行政区划

AOI 区域边界查询

能力标识：aoi

GET

根据 UID 获取 AOI 边界数据

输入

地点 UID：af7a23a1c6e2e21cc4257a99

输出

返回该地点的 AOI 边界数据，例如商场、园区或景区的面状范围，可用于地图绘制。

调用路径：/api/v1/aoi

常用输入项

uid

在线调试购买额度

城市数据 API

基于 ODS/DWD/DWS 三层城市 POI 数据库的查询接口，支持 JSON、GET 查询。

6 个接口

城市数据 API

城市概览

能力标识：city.summary

GET

按 city_code 返回该城市最新年份的 POI 总数、区县数、行业数及数据包列表。

输入

城市：上海

输出

返回上海最新年份的 POI 总数、区县数量、行业数量和可咨询的数据包。

调用路径：/city-data/api/cities/{city_code}/summary

在线调试购买额度

城市数据 API

城市区县分色地图

能力标识：city.district-map

GET

返回某城市（按年份/分类筛选）的区县分色地图数据，含 boundary_request 用于 Leaflet 渲染。

输入

城市：上海；年份：2023

输出

返回上海各区县的 POI 数量和地图分色数据，可用于区县热力地图。

调用路径：/city-data/api/cities/{city_code}/district-map

常用输入项

year category_l1 category_slug

在线调试购买额度

城市数据 API

城市区县 POI 统计

能力标识：city.district-stats

GET

按区县汇总 POI 数量、排名、同比增长，支持年份与行业筛选。

输入

城市：上海；年份：2023

输出

返回上海各区县 POI 数量、排名和增长情况，适合做区域对比。

调用路径：/city-data/api/cities/{city_code}/district-stats

在线调试购买额度

城市数据 API

城市行业占比

能力标识：city.category-stats

GET

按一级行业返回该城市指定年份的 POI 数量与占比。

输入

城市：上海；年份：2023

输出

返回上海各一级行业的 POI 数量和占比，例如餐饮、零售、生活服务等。

调用路径：/city-data/api/cities/{city_code}/category-stats

在线调试购买额度

城市数据 API

城市年度趋势

能力标识：city.year-trend

GET

返回城市跨年的 POI 总量曲线，支持行业切片。

输入

城市：上海；行业：餐饮消费

输出

返回该城市该行业历年 POI 数量曲线，用于观察增长或收缩趋势。

调用路径：/city-data/api/cities/{city_code}/year-trend

在线调试购买额度

城市数据 API

数据包列表

能力标识：city.products

GET

按城市/行业 slug 筛选可咨询的 POI 数据资源包。

输入

城市：上海

输出

返回上海可咨询的数据资源包列表，包含数据包名称、覆盖范围和适用场景。

调用路径：/city-data/api/products

在线调试购买额度

行业数据 API

基于 DWS 三级行业聚合的查询接口，自动暴露城市排行、区县分布、年度趋势。

6 个接口

行业数据 API

行业主题列表

能力标识：industry.topics

GET

按 level（1/2/3）或 parent 主题码筛选行业目录卡片。

输入

行业层级：一级行业

输出

返回行业主题目录，例如餐饮消费、汽车服务、医疗健康等大类。

调用路径：/industry-data/api/topics

常用输入项

level parent

在线调试购买额度

行业数据 API

行业主题详情

能力标识：industry.topic.detail

GET

一次性返回某行业的概览/子分类/城市排行/区县分布/省级分布/趋势，可指定 year 与 city_code。

输入

行业：餐饮消费；城市：上海

输出

返回该行业的概览、子分类、城市排行、区县分布、省级分布和年度趋势。

调用路径：/industry-data/api/topics/{topic_code}/detail

常用输入项

year city_code

在线调试购买额度

行业数据 API

行业城市排行

能力标识：industry.cities

GET

该行业下各城市的 POI 数量 TOP 排行。

输入

行业：餐饮消费；数量：20 个城市

输出

返回餐饮消费 POI 数量排名前 20 的城市，适合做市场规模比较。

调用路径：/industry-data/api/topics/{topic_code}/cities

常用输入项

year limit

在线调试购买额度

行业数据 API

行业区县分布

能力标识：industry.districts

GET

行业下区县级 POI TOP 50（默认全国）；指定 city_code 时返回该城市全部区县（带 boundary_request）。

输入

行业：餐饮消费；城市：上海

输出

返回上海各区县餐饮消费 POI 分布，包含区县排名和地图渲染数据。

调用路径：/industry-data/api/topics/{topic_code}/districts

常用输入项

city_code year

在线调试购买额度

行业数据 API

行业省级分布

能力标识：industry.provinces

GET

行业下各省级覆盖城市数与 POI 总数，便于全国地图分色。

输入

行业：餐饮消费

输出

返回各省覆盖城市数量和 POI 总量，可用于全国省级分布图。

调用路径：/industry-data/api/topics/{topic_code}/provinces

在线调试购买额度

行业数据 API

行业年度趋势

能力标识：industry.trend

GET

行业历年 POI 总量曲线。

输入

行业：餐饮消费

输出

返回该行业历年 POI 总量曲线，帮助判断行业扩张趋势。

调用路径：/industry-data/api/topics/{topic_code}/trend

在线调试购买额度

公开接口目录

地址解析

地理编码

逆地理编码

路径规划

驾车路径规划

步行路径规划

骑行路径规划

公交路径规划

POI 检索

POI 圆形区域检索

POI 多边形区域检索

区域边界与行政区划

AOI 区域边界查询

城市数据 API

城市概览

城市区县分色地图

城市区县 POI 统计

城市行业占比

城市年度趋势

数据包列表

行业数据 API

行业主题列表

行业主题详情

行业城市排行

行业区县分布

行业省级分布

行业年度趋势

准备开始接入？