轨迹云
    开发指南
    接口文档
  • 更新日志
    • 常见问题
    轨迹云
    接口文档
    轨迹重合分析

    概述

    本接口提供对两条轨迹进行重合度分析的能力， 同时支持返回重合度、重合里程、未重合里程及绑路后的优化轨迹。


    注：
    1、本服务属于高级服务，如需接入请在官网工单系统提交工单申请开通调用权限。

    请求URL

    https://apis.map.qq.com/tracks/trace/compare/
    Method：POST

    请求参数

    参数 必填 类型 说明 示例
    key 是 string 开发key：您可在控制台Key管理界面自行创建，且需要开启WebServiceAPI功能" key":“fcebc*****”
    added_fields 否 string 控制是否返回baseline(绑路优化后的基线轨迹),默认不返回 “added_fields”:“baseline”
    baseline 是 object 重合度分析的基线轨迹
    - track[] 是 array 轨迹点数组，数组中每一项代表一个定位坐标，多个坐标构成轨迹 "track:[{定位点},{…}]
    - - lat number 纬度 “lat”:40.048468
    - - lng number 经度 “lng”:116.281433
    - - loctime number 定位时间戳，单位：秒 “loctime”:1652338342
    - - accuracy number 定位精度，单位：米 “accuracy”:15
    - - direction number 方向角度，0-360度，0为正北，顺时针一周为360度 “direction”:22
    - - speed number 速度，单位：千米/小时 “speed”:33.4
    target 是 object 要对比分析轨迹
    - track[] 是 array 轨迹点数组，数组中每一项代表一个定位坐标，多个坐标构成轨迹 "track:[{定位点},{…}]
    - - lat number 纬度 “lat”:40.048468
    - - lng number 经度 “lng”:116.281433
    - - loctime number 定位时间戳，单位：秒 “loctime”:1652338342
    - - accuracy number 定位精度，单位：米 “accuracy”:15
    - - direction number 方向角度，0-360度，0为正北，顺时针一周为360度 “direction”:22
    - - speed number 速度，单位：千米/小时 “speed”:33.4

    响应结果

    名称 类型 是否必须 说明
    status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
    message string 是 状态说明
    request_id string 是 本次请求的唯一标识，由系统生成，用于追查结果有异常时使用
    result object 是 服务返回结果
    match_ratio number 否 轨迹重合度取值[0,1]
    match_distance number 否 重合的轨迹里程，单位：米
    mismatch_distance number 否 偏离的轨迹里程（单位：米）：基准轨迹里程 - 重合的轨迹里程
    baseline object 否 绑路优化后的基线轨迹 当传入"added_fields":"baseline"时返回
    distance number 否 优化后距离
    track array 否 优化纠偏后的轨迹点串，数组中每一项代表一个定位坐标，多个坐标构成轨迹
    lat number 否 纬度
    lng number 否 经度
    octime number 否 定位时间戳，单位：秒
    accuracy number 否 定位精度，单位：米
    direction number 否 方向角度，0-360度，0为正北，顺时针一周为360度
    speed number 否 速度，单位：千米/小时

    调用示例

    // POST请求，注意参数值要进行URL编码
    https://apis.map.qq.com/tracks/trace/compare/
    Content-Type:application/json

    //请求body：
{
    "key": "******",
    "baseline": {
        "track": [
            {
                "lat": 36.771432,
                "lng": 119.177476,
                "loctime": 1677556306
            },
           //其它定位点省略
]
    },
    "target": {
        "track": [
            {
                "lat": 36.769809,
                "lng": 119.178988,
                "loctime": 1677556306
            },
           //其它定位点省略
        ]
    }
}


    {
    "status": 0,
    "message": "Success",
    "request_id": "92d23b0af3ba4dd9bc1bc90625491ea93c8e3c583a03c70fd59cf2886386b58a",
    "result": {
        "match_ratio": 0,
        "match_distance": 1657,
        "mismatch_distance": 93,
    }
}
    本页内容