
统一入口、限流熔断、鉴权日志
以给定数据为中心、指定半径范围内检索 产品,可按类别过滤并按距离排序,返回每个 产品 与中心点的直线距离。适用于「附近门店」「附近网点」「周边配套」等场景。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
location | string | 是 | 中心点数据 |
radius | int | 否 | 半径(米),默认 1000,最大 50000 |
keywords | string | 否 | 关键词过滤 |
types | string | 否 | 类别编码过滤 |
sortrule | string | 否 | distance(默认按距离)或 weight |
key | string | 是 | 产品密钥(AppKey),在控制台申请 |
output | string | 否 | 返回格式,json(默认)或 xml |
sig | string | 否 | 数字签名,开启签名校验后必填 |
GET https://api.dzdzhineng.top/v3/place/around?key=您的AppKey&location=...支持 GET / POST,需使用 HTTPS;返回默认 JSON,可用 output=xml 切换。签名校验与 IP 白名单在控制台开启,见技术文档 · 鉴权。
{
"status": "1", "count": "26",
"pois": [{
"name": "浙江大学玉泉校区", "distance": "820",
"location": "120.126892,30.264751", "type": "科教文化服务;学校;高等院校"
}]
}| 错误码 | 说明 | 处理建议 |
|---|---|---|
10000 | 请求成功 | - |
10001 | key 不正确或过期 | 检查控制台密钥状态 |
10003 | 访问已超出日访问量 | 购买订阅套餐或次日再试 |
10004 | 单位时间内访问过于频繁 | 降低并发,或升级套餐提升 QPS |
10005 | IP 白名单出错 | 在控制台配置服务器 IP |
20000 | 产品参数非法 | 按文档检查参数名与取值 |
20001 | 缺少必填参数 | 补齐参数后重试 |
20003 | 请求协议非法 | 请使用 HTTPS |
30001 | 引擎返回数据异常 | 稍后重试,持续出现请提交工单 |