轨迹重合率分析API

POST

/trackmatch/v1/track

响应示例

 
{
    "status": 0,
    "message": "OK",
    "data": {
        "similarity": 97.33972803676709,
        "processed_standard_track": [
            {
                "loc": {
                    "longitude": 120.401143542438,
                    "latitude": 36.27159381983164
                },
                "loc_time": 1542702871
            },
            {
                "loc": {
                    "longitude": 120.40113828855124,
                    "latitude": 36.270452489393409
                },
                "loc_time": 1542702922
            },
            ...
        ],
        "processed_track": [
            {
                "loc": {
                    "longitude": 120.4011466648737,
                    "latitude": 36.271693510233969
                },
                "loc_time": 1542702871,
                "unmatched": 1
            },
            {
                "loc": {
                    "longitude": 120.40113828855124,
                    "latitude": 36.270452489393409
                },
                "loc_time": 1542702974
            },
            {
                "loc": {
                    "longitude": 120.40253992118626,
                    "latitude": 36.2704141350664
                },
                "loc_time": 1542702974
            },
            {
                "loc": {
                    "longitude": 120.40295813822128,
                    "latitude": 36.270305669161988
                },
                "loc_time": 1542702974
            },
           ...
        ],
        "standard_track_distance": 46761.142281986984,
        "track_distance": 46955.66684267597,
        "processed_standard_track_distance": 47758.28798339452,
        "processed_track_distance": 47758.28798339452,
        "unmatched_distance": 4301.566201098205,
        "matched_distance": 43456.721782296314
    }
}

请求参数

Query 参数

standard_track

string

必需

基准轨迹；standard_track被认为是一条标准轨迹/路线（通常可能是设定的标准路线），重合率计算时track将向standard_track进行匹配，track中与standard_track不匹配部分被认为是未匹配点（unmatched=1）轨迹数据规范：最多不能超过500个轨迹点，且轨迹里程不超过500公里（注：若轨迹里程超长，可能会出现响应时间过长或超时）。standard_track格式为json，其中每个point可按序填写以下字段值，其他字段会被舍弃： latitude,longitude,loc_time,radius,speed,direction,height 取值规则： latitude：必填，纬度，支持小数点后6位 longitude：必填，经度，支持小数点后6位 loc_time：不需要纠偏去噪时选填，需要纠偏去噪时必填。轨迹点的定位时间，使用UNIX时间戳（秒级） speed：选填，轨迹点的速度，double类型，单位：公里/小时 direction：选填，轨迹点的方向，int类型，单位：范围为[0,359]，0度为正北方向，顺时针方向递增 height：选填，轨迹点的高度，double类型，单位：米示例： 1. 若填写全部字段：["36.2817531985,120.392544449,1542695170,10,0,42,10", "36.2817531985,120.392544449,1542695176,10,0,42,10"] 2. 若省略部分可选字段，如不填speed字段： ["36.2817531985,120.392544449,1542695170,10,,42,10", "36.2817531985,120.392544449,1542695176,10,,42,10"]

示例值:

["36.2817531985,120.392544449,1542695170,10,0,42,10", "36.2817531985,120.392544449,1542695176,10,0,42,10"]

track

string

必需

待匹配轨迹；track是待分析的轨迹（通常可能是司机实际行驶的轨迹）轨迹数据规范

示例值:

同上

standard_option

string

可选

基准轨迹的纠偏参数设置；无默认值，若不填则使用原始轨迹进行重合率分析；若填写，则使用纠偏后轨迹进行重合率分析。支持以下配置项，多个项之间用”|”竖线相隔： 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

示例值:

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

option

string

可选

待匹配轨迹的纠偏参数设置

示例值:

同上

coord_type_input

string

可选

输入参数standard_track和track中轨迹点的坐标系；默认值：bd09ll 取值范围： gcj02：国测局加密坐标 bd09ll：百度经纬度坐标 wgs84：GPS所采用的坐标系

示例值:

bd09ll

coord_type_output

string

可选

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

示例值:

bd09ll

string

必需

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

默认值:

string

可选

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

默认值:

Body 参数application/octet-stream

未设置

返回响应

🟢200成功

application/json

Body

status

integer

详见状态码定义

必需

message

string

必需

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

similarity

number

必需

两条轨迹的匹配度；轨迹的相似度，取值范围[0,100]，值越大代表相似度越高

matched_distance

number

必需

匹配的轨迹历程；track和standard_track轨迹重合的里程单位：米

unmatched_distance

number

必需

偏离基准轨迹的里程；unmatched_distance=processed_track_distance-matched_distance 单位：米

processed_standard_track

object

必需

纠偏后的基准轨迹；仅在填写了standard_option请求参数时返回该字段

loc

object

轨迹点信息

必需

loc_time

integer

必需

轨迹点的定位时间，使用UNIX时间戳

processed_track

object

纠偏后的待匹配轨迹

必需

loc

object

轨迹点信息

必需

loc_time

integer

必需

轨迹点的定位时间，使用UNIX时间戳

unmatched

integer

必需

该轨迹点是否与processed_standard_track（若未填standard_option，则是standard_track）匹配。取值规则：匹配：则不返回该字段不匹配：值为1

standard_track_distance

number

必需

原始基准轨迹的里程；单位：米

track_distance

number

必需

原始待匹配轨迹的里程；单位：米

processed_standard_track_distance

number

必需

纠偏后的基准轨迹里程；若请求参数未填写standard_option，则采用原始轨迹里程单位：米

processed_track_distance

number

必需

纠偏后的待匹配轨迹里程；若请求参数未填写option，则采用原始轨迹里程单位：米

更新日志

服务介绍