轨迹云 / 开发指南 / 轨迹上传

概述

提供终端位置上传到轨迹云的能力，一次可上传指定终端多个定位点（形成的轨迹）。

轨迹上传

请求URL

URL： http://apis.map.qq.com/tracks/trace/upload
Method：POST
Header：Content-Type:application/json


请求参数

参数名 类型 必填 说明
key 必填 string 开发密钥（Key）
service_id 必 string 服务的唯一编号，需验证轨迹服务是否存在
entity_id 必 string 终端唯一id
coord_type 必 number 坐标系，1:GPS坐标（WGS84），5:火星坐标星（GCJ02坐标 - 默认）
data 必 array 轨迹数组，单次支持最多上传20个轨迹点
lat 必 double 纬度，小数点后最多保留8位
lng 必 double 经度，小数点后最多保留8位
loctime 必 number 定位时间戳，单位：秒，范围（365天内到未来10分钟）
speed 必 nubmer 速度，单位：米/秒，范围 >=0
direction 必 nubmer 方向角，正北0度，东90度，一周360
altitude 必 nubmer 高度
accuracy 必 nubmer 定位精度，单位：米
trace_fields 选 object 轨迹自定义字段
trace_field 选 string/number 轨迹自定义字段信息，以实际为准，自定义内容大小不得超过2k

响应结果

名称 类型 是否必须 说明
status 必 string 状态码，0代表成功，其他为失败
message 必 string 对status值的描述
request_id 必 string 请求ID，用于问题排查
result 必 object 返回结果
count 必 nubmer 上传成功的轨迹点数量
failure 否 array 上传失败的轨迹点数组
idx 否 nubmer 上传失败轨迹点索引
message 否 string 上传失败的原因说明

请求示例

//URL：https://apis.map.qq.com/tracks/trace/upload
//Method：POST请求
//请求头：content-type:application/json
{
    "key":"您的KEY",
    "service_id":"627b82b7fec5dc8ae4e242d0",
    "entity_id":"entity_001",
    "coord_type":5,
    "data":[
        {"lat":40.048468, "lng":116.281433,"loctime":1652338342,"speed":0.0,"direction":0.0,"altitude":10.0,"accuracy":40.0},
        {"lat":40.048468, "lng":116.281433,"loctime":1652338344,"speed":0.0,"direction":0.0,"altitude":10.0,"accuracy":40.0},
        {"lat":40.048468, "lng":116.281433,"loctime":1652338349,"speed":0.0,"direction":0.0,"altitude":0.0,"accuracy":40.0},
        {"lat":40.048468, "lng":116.281433,"loctime":1652338354,"speed":0.0,"direction":0.0,"altitude":20.0,"accuracy":40.0},
        {"lat":40.048468, "lng":116.281433,"loctime":1652338359,"speed":0.0,"direction":0.0,"altitude":12.0,"accuracy":40.0}
    ]
}

响应示例

{
    "status": 0,
    "message": "OK",
    "request_id": "a4ea512e-9372-402a-9560-a71fe1b4f597-3eb41a95b6928cbe",
    "result": {
        "count": 4,  //成功上传到轨迹云的定位点个数
        "failure": [   //上传失败的定位点
            {
                "idx": 2,   //上传失败的点在请求参数中的数组下标位置（便于您调试修正问题）
                "message": "illegal 'altitude'. value of altitude must be greater than 0"
            }
        ]
    }
}

这篇文章对您解决问题是否有帮助？

已解决
未解决