轨迹纠偏

POST

/rectify/v1/track

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://api.map.baidu.com/rectify/v1/track?point_list&ak=&sn='

响应示例

{
    "status":0,
    "message":"成功",
    "total":38,
    "distance":7004.2268595795,
    "toll_distance":0,
    "low_speed_distance":0,
    "points":[
        {
            "loc_time":1624295452,
            "latitude":36.271593819832,
            "longitude":120.40114354244,
            "speed":1.2875764132772,
            "direction":178.38227415059
        },
        {
            "loc_time":1624295615,
            "latitude":36.270452489393,
            "longitude":120.40113828855,
            "speed":8.4496861276931,
            "direction":93.59750062432
        },
        ...
        {
            "loc_time":1624296515,
            "latitude":36.241216624104,
            "longitude":120.36069744837,
            "speed":31.788581427876,
            "direction":130.91381579391
        }
    ]
}

请求参数

Query 参数

point_list

string

必需

轨迹点序列；最多不能超过2000个轨迹点，且轨迹里程不超过500公里（注：若轨迹里程超长，可能会出现响应时间过长或超时）。point_list格式为json，其中每个point必须包含：latitude,longitude,coord_type_input,loc_time这4个字段，可选speed,direction,height,radius这4个字段，其他字段会被舍弃。取值规则： latitude：纬度，支持小数点后6位 longitude：经度，支持小数点后6位 coord_type_input：轨迹点的坐标系，支持以下值：bd09ll（百度经纬度坐标）、gcj02（国测局加密坐标）、wgs84（GPS所采用的坐标系） loc_time：轨迹点的定位时间，使用UNIX时间戳（秒级） speed：轨迹点的速度，double类型，单位：公里/小时 direction：轨迹点的方向，int类型，单位：范围为[0,359]，0度为正北方向，顺时针方向递增 height：轨迹点的高度，double类型，单位：米 radius：定位时返回的定位精度，double类型，单位：米

rectify_option

string

可选

纠偏设置；支持以下配置项，多个项之间用”|”竖线相隔。默认值为：need_mapmatch:1|transport_mode:auto|denoise_grade:1|vacuate_grade:1 取值规则为： 1. need_mapmatch（绑路）是否需要将轨迹点绑路并补充道路形状点，示例： need_mapmatch:0 不绑路 need_mapmatch:1 绑路 2. transport_mode（交通方式）根据不同交通工具选择不同的纠偏策略和参数，目前支持：自动（即鹰眼自动识别的交通方式）、驾车、骑行和步行。示例： transport_mode:auto transport_mode:driving transport_mode:riding transport_mode:walking 3. 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定位点） 4. vacuate_grade（抽稀力度）取值范围[0,5]，数值越大抽稀度力度越大，代表轨迹会越稀疏。若取值0，则代表不抽稀。示例： vacuate_grade:0（不抽稀） vacuate_grade:2（抽稀力度为2）

示例值:

need_mapmatch:1|transport_mode:auto|denoise_grade:1|vacuate_grade:1

supplement_mode

string

可选

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

示例值:

no_supplement

coord_type_output

string

可选

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

示例值:

bd09ll

string

必需

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

默认值:

string

可选

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

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

详见状态码定义

必需

message

string

必需

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

total

string

必需

忽略掉page_index，page_size后的轨迹点数量；代表一共有多少条符合条件的track

distance

number

必需

此段轨迹的里程数，单位：米；符合条件的所有轨迹点的总里程。

toll_distance

number

必需

此段轨迹的收费里程数，单位：米；收费道路包括高速等收费路段。

points

object

历史轨迹点列表

必需

longitude

string

经度

必需

latitude

string

纬度

必需

loc_time

integer

必需

定位时的设备时间；该时间为用户上传的时间

direction

integer

必需

方向；范围为[0,359]，0度为正北方向，顺时针

height

number

必需

高度；只在GPS定位结果时才返回，单位米

speed

number

必需

速度；单位：km/h

radius

number

定位精度；单位：m

必需

coord_type

string

必需

坐标类型；该字段仅在海外区域时返回，返回值为：wgs84。当坐标位于国内（含港、澳、台）时，返回坐标类型与请求参数 coord_type_output 所设一致，因此不再返回该字段

更新日志

服务介绍