轨迹云
    开发指南
    接口文档
  • 更新日志
    • 常见问题
    轨迹云
    接口文档
    轨迹查询/优化

    概述

    查询指定终端在某时段内的移动轨迹；
    由于终端定位常常存在定位不准、定位失败、定位精度不高等情况，轨迹云提供了包含轨迹去噪、抽稀、绑路、补偿等一系列优化策略，尽可能还原真实轨迹。 在轨迹优化查询基础上，计算整段轨迹里程。

    轨迹查询/优化

    请求URL

    URL：https://apis.map.qq.com/tracks/trace/search
    Method：GET


    请求参数

    参数名 必填 说明 示例
    key 是 开发密钥（Key） key=xxx
    service_id 是 服务id，要添加终端的轨迹服务id，需验证轨迹服务是否存在 service_id=xxx
    entity_id 是 终端id entity_id=xxx
    start_time 是 开始时间戳，单位：秒 start_time=946656000
    end_time 是 结束时间戳，单位：秒 ，距离开始时间不能超过24小时 end_time=946742399
    get_fields 否 是否返回全部字段
    1[默认]返回全部字段（包括距离、耗时和轨迹）
    2只返回距离和耗时(不返回轨迹)    		 get_fields=1
    optimize 否 是否返回优化轨迹：
    0 返回原始轨迹（相关优化参数将忽略）
    1 [默认]返回优化轨迹    		 optimize=0
    mode 否 优化方式，目前支持：
    driving [默认]驾车方式    		 mode=driving
    denoising 否 去噪（去掉原始轨迹中的异常跳动的定位点）
    0 不去噪
    1 [默认]去噪（optimize=1时自动开启，不可关闭）    		 denoising=0
    accuracy 否 精度过滤，单位：米，精度大于此值的定位点将被过滤 ，默认不过滤
    注：查询优化轨迹时建议设置50    		 accuracy=50
    snaptoroads 否 是否绑路（将原始轨迹点吸附到路上）
    0 不绑路
    1 [默认]绑路（optimize=1时自动开启，不可关闭）
    compression 否 抽稀（对冗余定位点进行删除），0-5档：
    0 [默认]为不抽稀
    1到5档 数值越大，抽稀粒度越大（optimize=1时自动抽稀，可不设置）    		 compression=3
    supplement 否 是否补偿（当轨迹有中断的情况时，通过路线规划进行补充）：
    0 [默认]不补偿
    1 补偿    		 supplement=0
    page_next 否 下页页码，在请求第1页时不传page_index，返回结果中会有一个"page_next"的值，
    在请求第2页时，将其作为入参page_next的值，获取第2页数据，同理直到获取整条轨迹数据
    注：每页1000个轨迹点    		 page_next=xxx

    响应结果

    名称 类型 是否必须 说明
    status string 必 状态码，0代表成功，其他为失败
    message string 必 对status值的描述
    request_id string 必 请求ID，用于问题排查
    result object 必 返回结果
    count number 必 本次查询到的轨迹点总个数，
    本服务每页最多返回1000个轨迹点，超过此数量需要分页获取
    distance double 必 轨迹距离，单位：米
    duration number 必 轨迹耗时，单位：秒
    page_next string 必 下页页码，page_next将为空""时代表翻到了最后一页
    track array 必 轨迹数组。注：每页最多1000个轨迹点
    - object 必 轨迹对象
    lat double 必 纬度
    lng double 必 经度
    loctime number 必 定位时间戳，单位：秒
    speed nubmer 必 速度，单位：米/秒
    direction nubmer 必 方向
    altitude nubmer 必 高度
    accuracy nubmer 必 定位精度，单位：米
    type nubmer 必 轨迹点类型：0原始点，1优化点，2补偿点
    trace_fields object 必 轨迹自定义字段
    trace_field string/number 必 轨迹自定义字段信息，以实际为准

    响应示例

    {
    "status": 0,
    "message": "OK",
    "request_id": "35c6340f-1eb4-4743-b670-91951f3e5f2d-11ef7fc0bd71238a",
    "result": {
        "count": 1,
        "distance": 0,
        "duration": 0,
        "page_next": "",
        "track": [
            {
                "lat": 40.048468,
                "lng": 116.281433,
                "loctime": 1652338342,
                "accuracy": 40,
                "direction": 0,
                "speed": 0,
                "altitude": 10,
                "trace_fields": {
                    "number": 3
                },
                "type": 1
            }
        ]
    }
}
    本页内容