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

地址解析

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

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

在线调试购买流量豆

其他接口

未归类接口

2 个接口

其他接口

地址清洗（离线省市区识别与补全）

能力标识：address/clean

POST

残缺地址离线补全省市区（不返回经纬度、不调用在线地理编码）

输入

address：深圳市南山区科技园；strict：false

输出

返回“地址清洗（离线省市区识别与补全）”的查询结果，包含状态、数据内容和本次调用后的剩余流量豆。

调用路径：/api/v1/address/clean

常用输入项

address addresses strict

在线调试购买流量豆

其他接口

地址 POI 精确定位（模糊地址 → C1–C5 决策）

能力标识：address/poi-resolve

POST

模糊/脏地址落到可解释 POI：C1–C5 分类码 + 选用 POI + 坐标 + 判定理由；宁可诚实拒落不静默错点

输入

地址：广东省广州市黄埔区广本（可附校正地址、限定城市）

输出

返回 C1–C5 采纳决策：如 C1 精确匹配「广汽本田汽车有限公司」+ 坐标 + 可读判定理由；无法可靠定位时诚实返回 C4/C5，不静默给错点。

调用路径：/api/v1/address/poi-resolve

常用输入项

address corrected_address city_hint

在线调试购买流量豆

城市数据 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 区域边界查询

其他接口

地址清洗（离线省市区识别与补全）

地址 POI 精确定位（模糊地址 → C1–C5 决策）

城市数据 API

城市概览

城市区县分色地图

城市区县 POI 统计

城市行业占比

城市年度趋势

数据包列表

行业数据 API

行业主题列表

行业主题详情

行业城市排行

行业区县分布

行业省级分布

行业年度趋势

准备开始接入？