关键词 / 行政区划 / 行业 / 附近半径四种检索方式,覆盖餐饮、零售、地产、制造等 267 个行业; 坐标支持 GCJ02(高德、腾讯)与 WGS84(GPS、Google、OSM)双向精确换算,可自建地图底图直接打点。
公开浏览模式可直接看统计与接口说明;填 Key 后可实时检索。
四类检索方式与地图联动:结果自动打点,点列表定位到地图。填了 Key 即可直接查真实数据。
idx_title 索引,实测 3~20 ms;包含匹配需同时给城市/区划。coord=wgs84 传入,服务端换算 GCJ02 后再算包围盒,避免 300~500 m 偏移搜错地方。统一鉴权:请求头 X-API-Key 或 URL 参数 ?key=;健康检查与公开汇总免鉴权。
| 方法 | 路径 | 说明 | 典型耗时 |
|---|---|---|---|
| GET | /api/poi/search | 关键词 / 行政区划 / 行业组合检索,支持 qmode=prefix|contains、分页、with_total | 3~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 | /docs | Swagger 交互式文档,可直接在页面调试 | — |
三种最常用调用方式,复制即用。填了 Key 会自动替换成你的 Key。
开箱即用的工程细节:限流、并发、坐标、部署形态。
每个 Key 独立限流,默认 600 次/分钟,超限返回 429;Key 可随时在管理后台生成、禁用、改名。
X-API-Key 或 ?key=前缀检索走标题索引 3~20 ms;包含匹配走 ngram 全文索引子表,约 50 ms;元数据分布走 24 小时缓存。
limit+1 判 has_more库内为高德 GCJ02 源;coord=wgs84 时服务端迭代换算(往返误差 < 0.1 m),可直接叠到 OSM / Google / 自建瓦片。
门店选址与竞品分布、CRM 地址补全与去重、地图打点展示、城市/行业市场测算、数据清洗与标签化。
legacy=true 兼容旧版 8111 响应格式