查询轨迹里程

GET

/api/v3/track/getdistance

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://yingyan.baidu.com/api/v3/track/getdistance?service_id&entity_name&ak=&sn='

响应示例

{
  "status": 0,
  "message": "成功",
  "distance": "3634.7",
  "low_speed_distance": "349.3"
}

请求参数

Query 参数

service_id

integer

必需

service的ID，service 的唯一标识；在轨迹管理台创建鹰眼服务时，系统返回的 service_id

entity_name

string

必需

entity唯一标识

start_time

integer

开始时间

可选

end_time

integer

可选

结束时间；结束时间不能大于当前时间，且起止时间区间不超过24小时。为提升响应速度，同时避免轨迹点过多造成请求超时（3s）失败，建议缩短每次请求的时间区间，将一天轨迹拆分成多段进行拼接

is_processed

string

可选

是否返回纠偏后里程；默认值：0 取值规则： 0：关闭轨迹纠偏，返回原始轨迹 1：打开轨迹纠偏，返回纠偏后轨迹。

process_option

string

可选

纠偏选项；默认值为： denoise_grade=1,need_mapmatch=0,transport_mode=auto 取值规则为： 1.去噪 denoise_grade（去噪力度）取值范围[0,5]，数值越大去噪力度越大，代表越多的点会被当做噪点去除。若取值0，则代表不去噪。示例： denoise_grade=0 （不去噪） denoise_grade=1 （系统默认去噪） denoise_grade=2（系统默认去噪，同时去除定位精度低于500的轨迹点，相当于保留GPS定位点、大部分Wi-Fi定位点和精度较高的基站定位点） denoise_grade=3（系统默认去噪，同时去除定位精度低于100的轨迹点，相当于保留GPS定位点和大部分Wi-Fi定位点） denoise_grade=4（系统默认去噪，同时去除定位精度低于50的轨迹点，相当于保留GPS定位点和精度较高的Wi-Fi定位点） denoise_grade=5（系统默认去噪，同时去除定位精度低于20的轨迹点，相当于仅保留GPS定位点） 2.绑路，示例： need_mapmatch=0 不绑路 need_mapmatch=1 绑路 3.交通方式，鹰眼将根据不同交通工具选择不同的纠偏策略，目前支持：自动（即鹰眼自动识别的交通方式）、驾车、骑行和步行，示例： transport_mode=auto（根据轨迹鹰眼自动识别交通方式） transport_mode=driving（驾车） transport_mode=riding（骑行） transport_mode=walking（步行）

supplement_mode

string

可选

里程补偿方式；默认值：no_supplement，不补充在里程计算时，两个轨迹点定位时间间隔5分钟以上，被认为是中断。中断轨迹提供以下5种里程补偿方式。 no_supplement：不补充，中断两点间距离不记入里程。 straight：使用直线距离补充 driving：使用最短驾车路线距离补充 riding：使用最短骑行路线距离补充 walking：使用最短步行路线距离补充

low_speed_threshold

number

可选

低速阈值；单位：千米/小时若填写该值且is_processed=1时，则返回结果中将增加low_speed_distance字段，表示速度低于该值的里程。示例： low_speed_threshold=20，则返回结果中将增加low_speed_distance字段表示此段轨迹中速度低于20千米/小时的里程，可用于网约车行业中计算低速里程。

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

状态码

必需

message

string

必需

响应信息;对status的中文描述

distance

string

轨迹里程；单位：米

必需

low_speed_distance

string

必需

低速里程；单位：米若请求参数中填写了low_speed_threshold，则返回该字段，否则不返回代表速度低于low_speed_threshold的里程

修改于 2022-08-22 02:53:17

实时纠偏

轨迹查询与纠偏