给宠物一双会定位的眼睛，和一个能识图的大脑

632 万基站（含制式与坐标）

4 万WiFi 热点（合并去重）

50 m精度下限（估计值，非实测）

60 / 分默认配额，可申请提升

数据是自己的。定位库由我们的宠物设备上报后自学习沉淀（WiFi / BLE / 基站三路）， 不依赖外部开源库 —— 覆盖会随设备规模持续变好，而不是一次导入就固定。

边界：LBS 定位是已上线的自助 API；设备接入、状态判断与数据服务是项目制， 需要先谈协议与授权范围，不在本页提供密钥申请。

1. 拿到 Key：登录控制台自助创建（明文只显示一次）。
2. 替换占位符：把示例里的 YOUR_API_KEY 换成真实 Key —— 真 Key 只放服务端。
3. 打一条：期望返回 code: 0 且 data 里有 lat / lng。

curl -X POST https://api.aipite.com/open/v1/lbs/locate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"wifi":[{"bssid":"a0:b1:c2:d3:e4:f5","rssi":-61}],
       "cell":[{"mcc":460,"mnc":0,"lac":7025,"cid":178957508,"rssi":-75}]}'

期望响应：{"code":0,"msg":"ok","data":{"lat":30.48,"lng":114.40,...}}； 若返回 code:40101，是 Key 不对或没带鉴权头。

请求

{
  "wifi": [{ "mac": "AA:BB:CC:DD:EE:FF", "rssi": -70 }],
  "cell": { "mcc": 460, "mnc": 0, "lac": 7025, "cid": 49498985 }
}

响应

{
  "code": 0, "msg": "ok",
  "data": {
    "lat": 23.379925, "lng": 104.221275,
    "accuracy": 200,      // 估计精度（米），不是实测
    "confidence": 1,      // 命中率 matched/total
    "source": "wifi",     // wifi | cell
    "matched": 1, "total": 1
  }
}

关于 accuracy：它是估计值，不是设备实测定位精度 —— 按命中点离散度估算， 下限 50 米、单点 200 米、基站 1000 米。自建库的坐标来自历史聚合，不可能比几十米更准， 所以不写更小的数字。

限流与配额

• 默认 60 次/分钟、10000 次/天，按 Key 独立计数；超出返回 42901 / 42902。
• Key 在 控制台自助创建与管理（可停用、可删除、可重建）。
• 调用次数与最近使用时间在控制台「概览 / API Key」页可见；需要提额走商务对接。
• 建议一次提交 ≥3 个 WiFi 热点：只给 1 个热点时经常 code=0 + data=null（库里没这个热点），这不是报错。

错误码

示例

# 把 YOUR_API_KEY 换成自己的 key（不要在浏览器/前端里放真 key）
curl -X POST https://api.aipite.com/open/v1/lbs/locate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wifi":["AA:BB:CC:DD:EE:FF","11:22:33:44:55:66","77:88:99:AA:BB:CC"]}'

请勿在前端使用真 Key。本接口面向服务端调用 —— 浏览器/小程序里直接放 key 会被抓包， 应经由你自己的后端转发。

632 万基站（含制式与坐标）

4 万WiFi 热点（合并去重）

三路WiFi + BLE + 基站自学习

持续随设备上报量累积

• 每条设备上报都会带上当时的位置与扫到的 WiFi/BLE/基站，构成一次「观测」。
• 同一热点多次观测后按样本数收敛，越常被扫到的点，反查越稳。
• 不自建爬取、不依赖外部开源库 —— 所以覆盖面的边界是「我们的设备去过哪里」。