淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
order_id	String	必须	12131212		订单id
route_type	Number	必须	2		路线类型 1-接客路线 2-送客路线

名称	类型	示例值	描述
errno	Number	0	错误码
errmsg	String	SUCCESS	错误信息
errcode	String	SUCCESS	二级错误码
data	DriverRouteGetResult		司机路线获取结果
└ route_type Number 1 路线类型（1-接客路线 2-送客路线 3-等客状态） └ order_id String 12131212 订单号 └ route_id String 423123123 路线id └ all_length Number 10000 当前导航路线的总长度，单位米 └ all_time Number 5000 当前导航路径所需的时间，单位为秒 relay_order_steps LineStepInfo [] 接力单路线步骤（存在接力单且未完成则必须返回，指的是司机当前位置到上一单乘客终点的路线） links LinkInfo [] 路线 └ road_name String XX大道该Link道路名称 └ coords String 123.111,30.111;123.222,30.222 该Link道路坐标点集 └ traffic_status Number 0 路况状态：0-未知状态，1-通畅，2-缓行，3-阻塞，4-严重阻塞 └ link_type Number 0 道路类型 0-普通道路 1-航道 2-隧道 3-桥梁 4-高架桥 └ time Number 10 该Link道路耗时 └ length Number 100 该Link道路长度 └ time Number 100 该路段耗时，单位秒 └ length Number 1000 该路段长度，单位m └ end_location String 123.222,30.222 结束经纬度 └ start_location String 123.111,30.111 开始经纬度 steps LineStepInfo [] 路线步骤（按路段分）按照route_type返回接客路线或者送客路线，注意需要返回剩余路线，不是全程路线 links LinkInfo [] 路线 └ road_name String XX大道该Link道路名称 └ coords String 123.111,30.111;123.222,30.222 该Link道路坐标点集 └ traffic_status Number 0 路况状态：0-未知状态，1-通畅，2-缓行，3-阻塞，4-严重阻塞 └ link_type Number 0 道路类型 0-普通道路 1-航道 2-隧道 3-桥梁 4-高架桥 └ time Number 10 该Link道路耗时 └ length Number 100 该Link道路长度 └ time Number 100 该路段耗时，单位秒 └ length Number 1000 该路段长度，单位m └ end_location String 123.222,30.222 结束经纬度 └ start_location String 123.111,30.111 开始经纬度 driver_eta_info DriverEtaInfo 司机ETA信息 └ direction String 45.5 司机方向，正北为0度，顺时针方向 └ speed String 20 车速，正数表示向前，负数表示向后，单位是 m/s └ lng String 120.1111 经度 └ lat String 30.1111 维度 └ timestamp Number 1721101110 时间戳 └ remain_light_count Number 2 剩余红绿灯数 └ remain_time Number 100 剩余时间(秒) └ remain_length Number 1000 剩余里程(米) └ relay_order_remain_length Number 2000 接力单剩余路线长度，单位米（存在接力单且未完成必须） └ relay_order_remain_time Number 100 接力单剩余所需的时间，单位为秒（存在接力单且未完成必须）

{"route_type":2,"order_id":"12131212"}

{
    "errno":0,
    "errmsg":"SUCCESS",
    "errcode":"SUCCESS",
    "data":{
        "route_type":1,
        "order_id":"12131212",
        "route_id":"423123123",
        "all_length":10000,
        "all_time":5000,
        "relay_order_steps":[
            {
                    "links":[
                        {
                                "road_name":"XX大道",
                                "coords":"123.111,30.111;123.222,30.222",
                                "traffic_status":0,
                                "link_type":0,
                                "time":10,
                                "length":100
                        }
                    ],
                    "time":100,
                    "length":1000,
                    "end_location":"123.222,30.222",
                    "start_location":"123.111,30.111"
            }
        ],
        "steps":[
            {
                    "links":[
                        {
                                "road_name":"XX大道",
                                "coords":"123.111,30.111;123.222,30.222",
                                "traffic_status":0,
                                "link_type":0,
                                "time":10,
                                "length":100
                        }
                    ],
                    "time":100,
                    "length":1000,
                    "end_location":"123.222,30.222",
                    "start_location":"123.111,30.111"
            }
        ],
        "driver_eta_info":{
            "direction":"45.5",
            "speed":"20",
            "lng":"120.1111",
            "lat":"30.1111",
            "timestamp":1721101110,
            "remain_light_count":2,
            "remain_time":100,
            "remain_length":1000
        },
        "relay_order_remain_length":2000,
        "relay_order_remain_time":100
    }
}

{"errcode":"sign-check-failure","errno":"不等于0","errmsg":"Illegal request"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

商旅API

qimen.alitrip.btripcar.taxi.driver.route.get (获取司机行驶路线)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ