createjob接口创建任务

GET

/api/v3/frequentroute/createjob

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

{
    "status": 0,
    "message": "OK",
    "data": {
        "total": 2,
        "routes": [
            {
                "points": [
                    {
                        "longitude": 113.815534,
                        "latitude": 22.729928,
                        "loc_time": 1585699998,
                        "direction": 247,
                        "speed": 1.73
                    },
                    {
                        "longitude": 113.815469,
                        "latitude": 22.729904,
                        "loc_time": 1585700013,
                        "direction": 67,
                        "height": 28.0,
                        "speed": 6.84
                    },
                    …
                    {
                        "longitude": 113.913771,
                        "latitude": 22.794525,
                        "loc_time": 1585701885,
                        "direction": 123,
                        "height": 1.0,
                        "speed": 5.63
                    },
                    {
                        "longitude": 113.91447,
                        "latitude": 22.794097,
                        "loc_time": 1585701940,
                        "direction": 123,
                        "height": 2.0,
                        "speed": 5.63
                    }
                ],
                "distance": 18082.59,
                "average_speed": 50.89,
                "frequency": 0.25,
                "duration": 1942,
                "start_time_range": "7:8:51,13:32:52",
                "end_time_range": "7:37:14,14:15:50",
                "start_point": {
                    "longitude": 113.815534,
                    "latitude": 22.729928
                },
                "end_point": {
                    "longitude": 113.91447,
                    "latitude": 22.794097
                }
            },
            {
                "points": [
                    {
                        "longitude": 113.914526,
                        "latitude": 22.794701,
                        "loc_time": 1585736279,
                        "direction": 308,
                        "speed": 5.44
                    },
                    {
                        "longitude": 113.914178,
                        "latitude": 22.794957,
                        "loc_time": 1585736299,
                        "direction": 220,
                        "height": 9.0,
                        "speed": 16.55
                    },
                    …
                    {
                        "longitude": 113.815974,
                        "latitude": 22.730096,
                        "loc_time": 1585738602,
                        "direction": 247,
                        "height": 12.0,
                        "speed": 2.97
                    },
                    {
                        "longitude": 113.815601,
                        "latitude": 22.729954,
                        "loc_time": 1585738683,
                        "direction": 247,
                        "speed": 2.97
                    }
                ],
                "distance": 20430.13,
                "average_speed": 49.84,
                "frequency": 0.23,
                "duration": 2404,
                "start_time_range": "17:50:22,19:9:12",
                "end_time_range": "18:40:21,19:41:33",
                "start_point": {
                    "longitude": 113.914526,
                    "latitude": 22.794701
                },
                "end_point": {
                    "longitude": 113.815601,
                    "latitude": 22.729954
                }
            }
        ]
    }
}

请求参数

Query 参数

service_id

integer

必需

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

entity_name

integer

必需

entity唯一标识

start_time

integer

可选

起始时间（起始的loc_time）

示例值:

1585670400

end_time

string

可选

结束时间（结束的loc_time）；结束时间不超过当前时间，不能早于起始时间，且与起始时间差在24*31小时（即一个月）之内。

示例值:

1588176000

time_range

string

可选

时间容忍度阈值；取值范围[1,1440]，单位：分钟。出发时间是判断两个原始行程是否会被聚类为一条经验路线的时间纬度特征。若两个原始行程路线一致，但出发时间差值大于该阈值，则将被聚类至2条备选的经验路线中。例如，当time_range=180时，两个路线相同的行程出发时间分别为早晨8点和中午12点，则将被聚类至2条备选经验路线中；若出发时间分别为早晨8点和早晨9点，则将被聚类至1条备选经验路线中。若开发者不希望用出发时间来区分不同的经验路线，即不论何时出发，只要路线一致都被认为是一条经验路线，则设置time_range=1440，24小时即可。

示例值:

240

is_processed

string

可选

是否采用纠偏后轨迹来进行经验路线分析；默认值：0 取值规则： 0：关闭轨迹纠偏，返回原始轨迹 1：打开轨迹纠偏，返回纠偏后轨迹

示例值:

process_option

string

可选

纠偏选项；仅在is_processed=1时生效。默认值为： denoise_grade=1,need_mapmatch=0,transport_mode=auto,vacuate_grade=1 取值规则为： 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 4.抽稀取值范围[0,5]，数值越大抽稀度力度越大，代表轨迹会越稀疏。若取值0，则代表不抽稀。示例： vacuate_grade:0（不抽稀） vacuate_grade:2（抽稀力度为2）

示例值:

need_denoise=1,need_vacuate=1,need_mapmatch=1,radius_threshold=100,transport_mode=driving

supplement_mode

string

可选

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

示例值:

driving

coord_type_output

string

可选

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

示例值:

bd09ll

page_size

string

可选

示例值:

5000

page_index

string

可选

示例值:

string

必需

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

默认值:

string

可选

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

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

状态码

必需

message

string

必需

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

total

integer

必需

经验路线条数 , 代表一共有分析出多少条经验路线，

routes

array [object {8}]

必需

经验路线列表; 每条经验路线取一条实际轨迹作为代表。返回的路线将按出行频率从高至低排序，并剔除了里程过短、轨迹点数过少的经验路线。

duration

integer

可选

路线耗时
;单位：秒

distance

number

可选

路线距离;保留小数点后2位，单位：米

frequency

number

可选

路线出行频率 ; 出行频率为该经验路线的原始行程个数/总行程个数，保留小数点后2位。

start_time_range

string

可选

出发时间区间 ;该经验路线用户出发的最早和最晚时间，格式：hh:mm:ss, hh:mm:ss
示例："start_time_range":"7:8:51,13:32:52"

end_time_range

string

可选

到达时间区间 ; 该经验路线用户到达的最早和最晚时间，格式：hh:mm:ss, hh:mm:ss
示例："end_time_range":"17:26:29,19:11:54"

start_point

object

可选

end_point

object

可选

points

object

经验路线轨迹点

可选

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

经验行为分析

getjob接口定期查询任务