停留点查询

GET

/api/v3/analysis/staypoint

查询entity在指定时间段内的停留点。停留点判断规则为：在stay_radius半径范围内，滞留stay_time以上，被认为是一次停留，将取一个代表性坐标作为停留点，其中 stay_radius 默认为20米，stay_time 默认为 600秒。

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://yingyan.baidu.com/api/v3/analysis/staypoint?service_id&entity_name&start_time&end_time&ak=&sn='

响应示例


  {
    status: 0,
    message: "成功",
    staypoint_num: 3,
    stay_points: [
   {
    start_time: 1464164829,
    end_time: 1464166832,
    duration: 2003,
    stay_point: {
        longitude: 113.22167932597,
        latitude: 23.411219209009,
        coord_type: 3
     }
   },
   {
    start_time: 1464170138,
    end_time: 1464171664,
    duration: 1526,
    stay_point: {
        longitude: 113.20923398543,
        latitude: 23.411707425027,
        coord_type: 3
    }
   },
   {
    start_time: 1464172067,
    end_time: 1464172952,
    duration: 885,
    stay_point: {
        longitude: 113.207836,
        latitude: 23.40664,
        coord_type: 3
     }
   }
  ]
 }

请求参数

Query 参数

service_id

integer

必需

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

entity_name

string

必需

entity名称，作为其唯一标识

start_time

integer

开始时间

必需

end_time

integer

结束时间

必需

stay_time

integer

可选

停留时间；单位：秒，默认值：600。该字段用于设置停留点判断规则，即若系统判断在半径为stay_radius的圆形范围内停留时间超过stay_time，则被认为是一次停留

stay_radius

integer

可选

停留半径；单位：米，取值范围：[1,500]，默认值：20。该字段用于设置停留点判断规则，即若系统判断在半径为stay_radius的圆形范围内停留时间超过stay_time，则被认为是一次停留

process_option

string

可选

纠偏选项，用于控制返回坐标的纠偏处理方式；默认值为： need_mapmatch=0,transport_mode=driving 取值规则为： 1.绑路，示例： need_mapmatch=0：不绑路 need_mapmatch=1：绑路 2.交通方式，鹰眼将根据不同交通工具选择不同的纠偏策略，目前支持驾车、骑行和步行，示例： transport_mode=driving transport_mode=riding transport_mode=walking

coord_type_output

string

可选

返回的坐标类型；默认值：bd09ll 该字段用于控制返回结果中的坐标类型。可选值为： gcj02：国测局加密坐标 bd09ll：百度经纬度坐标该参数仅对国内（包含港、澳、台）轨迹有效，海外区域轨迹均返回 wgs84坐标系

string

必需

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

默认值:

string

可选

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

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

必需

状态码; 返回状态，0为成功

message

string

必需

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

staypoint_num

integer

必需

停留次数;本段行程中停留次数

stay_points

array [object {4}]

必需

停留记录列表;数组中每个元素代表一次停留，记录一个停留点坐标

start_time

integer

停留开始时间

可选

end_time

integer

停留结束时间

可选

duration

integer

停留时长

可选

stay_point

object

停留点

可选

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

轨迹分析

驾驶行为分析