快递查询地图轨迹技术文档

1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回格式支持JSON，xml，text，html数据。

2 请求地址

https://poll.kuaidi100.com/poll/maptrack.do

请求参数（header）

请求参数（body）

param数据结构：

3 请求实例

customer = **
sign = **
param = {
    "com": "ems",
    "num": "em263999513jp",
    "phone": "13868688888",
    "from": "广东省深圳市南山区金蝶软件园",
    "to": "北京朝阳区国际金融大厦",
    "resultv2": "5",
    "show": "0",
    "order": "desc"
}

4 返回结果

5 提供数据内容

{
    "message": "ok",
    "nu": "YT2556765456761",
    "ischeck": "0",
    "com": "yuantong",
    "status": "200",
    "data": [
        {
            "time": "2025-06-13 15:56:19",
            "context": "您的快件离开【安徽省六安市叶集实验区】，已发往【安徽省六安市】",
            "ftime": "2025-06-13 15:56:19",
            "areaCode": "CN341522000000",
            "areaName": "安徽,六安市,霍邱县",
            "status": "在途",
            "location": "六安市,霍邱县",
            "areaCenter": "116.277912,32.353038",
            "areaPinYin": "huo qiu xian",
            "statusCode": "0"
        },
        {
            "time": "2025-06-13 15:53:52",
            "context": "您的快件在【安徽省六安市叶集实验区】已揽收",
            "ftime": "2025-06-13 15:53:52",
            "areaCode": "CN341522000000",
            "areaName": "安徽,六安市,霍邱县",
            "status": "揽收",
            "location": "六安市,霍邱县",
            "areaCenter": "116.277912,32.353038",
            "areaPinYin": "huo qiu xian",
            "statusCode": "1"
        }
    ],
    "state": "0",
    "condition": "00",
    "routeInfo": {
        "from": {
            "number": "CN430112000000",
            "name": "湖南,长沙市,望城区"
        },
        "cur": {
            "number": "CN341522000000",
            "name": "安徽,六安市,霍邱县"
        },
        "to": {
            "number": "CN320583104000",
            "name": "江苏,苏州市,昆山市,花桥镇"
        }
    },
    "isLoop": false,
    "trailUrl": "https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3",
    "arrivalTime": "2025-06-14 13",
    "totalTime": "0天21小时",
    "remainTime": "0天20小时",
    "probability": "98",
    "predictedRoute": [
        {
            "arriveTime": "2025-06-13 15:53:52",
            "leaveTime": "2025-06-13 15:56:19",
            "province": "安徽",
            "city": "六安市",
            "district": "叶集区",
            "name": "安徽省六安市叶集实验区",
            "state": "已经过节点",
            "type": "网点",
            "location": "115.916567,31.870774"
        },
        {
            "arriveTime": "2025-06-13 19:05:19",
            "leaveTime": "2025-06-13 19:59:19",
            "province": "安徽",
            "city": "六安市",
            "district": "金安区",
            "name": "安徽省六安市",
            "state": "预估途径节点",
            "type": "网点",
            "location": "116.542475,31.791007"
        },
        {
            "arriveTime": "2025-06-13 23:09:19",
            "leaveTime": "2025-06-13 23:16:19",
            "province": "安徽",
            "city": "合肥市",
            "district": "肥东县",
            "name": "合肥转运中心",
            "state": "预估途径节点",
            "type": "转运中心",
            "location": "117.4779,31.878601"
        },
        {
            "arriveTime": "2025-06-14 06:58:19",
            "leaveTime": "2025-06-14 07:17:19",
            "province": "江苏",
            "city": "无锡市",
            "district": "新吴区",
            "name": "苏州转运中心",
            "state": "预估途径节点",
            "type": "转运中心",
            "location": "120.434818,31.562407"
        },
        {
            "arriveTime": "2025-06-14 12:29:19",
            "leaveTime": "2025-06-14 13:46:19",
            "province": "江苏",
            "city": "苏州市",
            "district": "昆山市",
            "name": "江苏省昆山市城区",
            "state": "预估途径节点",
            "type": "网点",
            "location": "120.919516,31.341652"
        }
    ]
}

6 运单签收状态（state)说明

注：如需物流状态高级状态名称及状态值需要 resultv2 传 “5” 返回

7 轨迹链接应用示例

8 错误返回示例

{
    "result": false,
    "returnCode": "400",
    "message": "找不到对应公司"
}