基于三轴加速度信号的波峰检测与自适应阈值计步算法，输入 X/Y/Z 三轴原始加速度序列（单位 mg，静止时竖直轴约 9810），即可返回该时段内的步数与平均正常步长（米）。\n\n算法对佩戴姿态与个体差异做了自适应处理，单次请求每轴最多 4096 个采样点，典型响应耗时 50~150ms，适合可穿戴设备与移动端按窗口（如每 10~30 秒）批量上报后统计。
能力特点
- 三轴融合波峰检测 + 自适应阈值，适配不同佩戴姿态
- 同时输出步数与平均正常步长（米），可直接换算步行距离
- 支持整数与浮点输入，单位为 mg（1g ≈ 9810）
适用场景
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
x | array[int] | 是 | X 轴加速度序列，单位 mg（1g ≈ 9810），单轴最多 4096 点 |
y | array[int] | 是 | Y 轴加速度序列，单位 mg |
z | array[int] | 是 | Z 轴加速度序列，单位 mg |
sample_rate | int | 否 | 采样率（Hz），当前版本内部按固定频率处理，传入不影响结果 |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
step | int | 识别出的步数 |
normal_step_length | float | 平均正常步长估计，单位米 |
algo | string | 算法版本号 |
error | string | 仅在出错时出现，如 missing axis data / too many samples |
错误码
| code | HTTP | 含义 | 处理建议 |
|---|---|---|---|
0 | 200 | 成功 | 请求正常处理完成。 |
40101 | 401 | 缺少鉴权 | 请求头未携带 Authorization，请检查 Bearer Token。 |
40102 | 401 | Key 无效 | API Key 不存在或已被吊销，请到控制台确认。 |
40103 | 403 | 算法未开通 | 当前 Key 未开通该算法，请先在控制台申请权限。 |
40104 | 403 | 来源不合法 | 云函数侧内部凭证校验失败，请经门户网关调用，勿直连算法后端。 |
40105 | 503 | 后端未校验 | 算法后端未通过内部凭证校验，网关已拒绝转发，需管理员在算法运维页重新校验。 |
42901 | 429 | 超出配额 | 当日调用量已达上限，可升级套餐或次日重试。 |
42201 | 422 | 参数错误 | 必填参数缺失或类型不正确，见 detail 字段。 |
50001 | 502 | 算法后端异常 | 上游算法执行失败，request_id 可用于排查。 |
50002 | 504 | 算法超时 | 单次请求超过 30 秒，请缩小输入后重试。 |
request.json
{
"x": [
120,
118,
122,
119,
121,
117
],
"y": [
80,
82,
79,
81,
83,
78
],
"z": [
9810,
10320,
12410,
9900,
10380,
12460
],
"sample_rate": 50
}
response.json
{
"algo": "4.2.0",
"normal_step_length": 0.6060419678688049,
"step": 112
}
指标表现
算法版本4.2.0
单轴最大点数4096
单次响应< 150ms