● 服务运行中 · 8000 万条 POI · 毫秒级响应

中国 POI 数据 检索 API
一次接入,全量兴趣点随取随用

关键词 / 行政区划 / 行业 / 附近半径四种检索方式,覆盖餐饮、零售、地产、制造等 267 个行业; 坐标支持 GCJ02(高德、腾讯)与 WGS84(GPS、Google、OSM)双向精确换算,可自建地图底图直接打点。

API 文档 / Swagger

公开浏览模式可直接看统计与接口说明;填 Key 后可实时检索。

80,082,641POI 总量
—行业覆盖
—省份覆盖
<100ms索引检索
600/分默认限流
GCJ02/WGS84双坐标

1在线检索工作台

四类检索方式与地图联动:结果自动打点,点列表定位到地图。填了 Key 即可直接查真实数据。

前缀检索走 idx_title 索引,实测 3~20 ms;包含匹配需同时给城市/区划。
行政区分省 / 市 / 区县三级精确匹配;行业筛选建议配合城市使用(行业基数大)。
GPS 坐标按 coord=wgs84 传入,服务端换算 GCJ02 后再算包围盒,避免 300~500 m 偏移搜错地方。
明细返回全部字段:名称、地址、行政区划、行业、电话、坐标、高德分类、商圈等。
检索结果
底图 Protomaps © OpenStreetMap 贡献者 · 本机自建瓦片(WGS84)
搜索结果会自动打点;点右侧列表可定位。

2接口清单

统一鉴权:请求头 X-API-Key 或 URL 参数 ?key=;健康检查与公开汇总免鉴权。

方法路径说明典型耗时
GET/api/poi/search关键词 / 行政区划 / 行业组合检索,支持 qmode=prefix|contains、分页、with_total3~200 ms
GET/api/poi/nearby半径最近检索(Haversine + 经纬度包围盒),可带行业过滤,返回距离0.3~1 s
GET/api/poi/suggest名称前缀补全,适合做输入联想~10 ms
GET/api/poi/{poi_id}单条明细全字段<10 ms
GET/api/poi/meta/stats总量 + 行业 / 省份 TOP 分布缓存内 ~0 ms
GET/api/poi/meta/cities城市分布(可按省份过滤)缓存内 ~0 ms
GET/api/poi/meta/industries行业分布(可按城市过滤)缓存内 ~0 ms
GET/api/poi/summary 免Key公开汇总(总量 + TOP 行业/省份),只读缓存~1 ms
GET/api/health 免Key健康检查(含数据库探活)~2 ms
GET/docsSwagger 交互式文档,可直接在页面调试—

3代码示例

三种最常用调用方式,复制即用。填了 Key 会自动替换成你的 Key。

cURL
Python
JavaScript

4接入与能力

开箱即用的工程细节:限流、并发、坐标、部署形态。

🔑鉴权与限流

每个 Key 独立限流,默认 600 次/分钟,超限返回 429;Key 可随时在管理后台生成、禁用、改名。

  • 请求头 X-API-Key 或 ?key=
  • 多 Key 隔离,按 Key 统计 30 天调用量

⚡性能

前缀检索走标题索引 3~20 ms;包含匹配走 ngram 全文索引子表,约 50 ms;元数据分布走 24 小时缓存。

  • 单 worker + 连接池,实测 20 并发无压力
  • 深度分页用 limit+1 判 has_more

🧭坐标体系

库内为高德 GCJ02 源;coord=wgs84 时服务端迭代换算(往返误差 < 0.1 m),可直接叠到 OSM / Google / 自建瓦片。

  • 附近检索传 GPS 坐标会自动先换算
  • 页面里的地图就是自建矢量瓦片

📦典型用途

门店选址与竞品分布、CRM 地址补全与去重、地图打点展示、城市/行业市场测算、数据清洗与标签化。

  • 支持 legacy=true 兼容旧版 8111 响应格式
  • 需要开通或更大额度:[email protected]