淘宝开放平台

登录
文档中心 > API类目 > 商旅API

商旅API

qimen.alitrip.btripcar.taxi.driver.select.route.confirm (确认线上选路选择司机路线)

商旅用车在线选路确认选择的司机路线

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id String 必须 123456754 供应商订单号
route_id String 必须 1231231232 路线id

响应参数

名称 类型 示例值 描述
errno Number 0 错误码
errmsg String SUCCESS 错误信息
errcode String SUCCESS 二级错误码
data SelectRouteConfirmResult 选路确认结果
  • route
  • SelectRouteInfo
  • 123456754
  • 路线
  • steps
  • LineStepInfo []
  • 路线步骤（按路段分）
  • links
  • LinkInfo []
  • 路线
  • └ coords
  • String
  • 120.111,30.111;120.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道路长度 单位米
  • └ road_name
  • String
  • XX大道
  • 该Link道路名称
  • └ traffic
  • String
  • 1-0;155-1;162-0
  • 路况(对标高德的格式)
  • └ time
  • Number
  • 10
  • 该路段耗时
  • └ length
  • Number
  • 100
  • 该路段长度
  • └ end_location
  • String
  • 120.222,30.222
  • 结束经纬度
  • └ start_location
  • String
  • 120.111,30.111
  • 开始经纬度
  • └ estimated_price
  • String
  • 50
  • 预估价 单位元 全程价格
  • └ tolls
  • String
  • 5
  • 路桥费 单位元
  • └ light
  • Number
  • 3
  • 红绿灯个数
  • └ distance
  • Number
  • 100
  • 距离 单位米
  • └ cost_time
  • Number
  • 1000
  • 耗时 单位秒
  • └ route_desc
  • String
  • 时间最快
  • 路线描述
  • └ route_id
  • String
  • 12345412
  • 路线id
  • driver_eta_info
  • DriverEtaInfo
  • 司机ETA信息
  • └ direction
  • String
  • 40
  • 司机方向，正北为0度，顺时针方向
  • └ speed
  • String
  • 20
  • 车速，正数表示向前，负数表示向后，单位是 m/s
  • └ lng
  • String
  • 30.123
  • 经度
  • └ lat
  • String
  • 120.123
  • 维度
  • └ timestamp
  • Number
  • 1721112299
  • 时间戳
  • └ remain_light_count
  • Number
  • 3
  • 剩余红绿灯数
  • └ remain_time
  • Number
  • 100
  • 剩余时间(秒)
  • └ remain_distance
  • Number
  • 1000
  • 剩余里程(米)
  • └ order_id
  • String
  • 123456754
  • 供应商订单号

请求示例

1
{"route_id":"1231231232","order_id":"123456754"}

响应示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
{
    "errno":0,
    "errmsg":"SUCCESS",
    "errcode":"SUCCESS",
    "data":{
        "route":{
            "steps":[
                {
                        "links":[
                            {
                                    "coords":"120.111,30.111;120.222,30.222",
                                    "traffic_status":0,
                                    "link_type":0,
                                    "time":10,
                                    "length":100,
                                    "road_name":"XX大道",
                                    "traffic":"1-0;155-1;162-0"
                            }
                        ],
                        "time":10,
                        "length":100,
                        "end_location":"120.222,30.222",
                        "start_location":"120.111,30.111"
                }
            ],
            "estimated_price":"50",
            "tolls":"5",
            "light":3,
            "distance":100,
            "cost_time":1000,
            "route_desc":"时间最快",
            "route_id":"12345412"
        },
        "driver_eta_info":{
            "direction":"40",
            "speed":"20",
            "lng":"30.123",
            "lat":"120.123",
            "timestamp":1721112299,
            "remain_light_count":3,
            "remain_time":100,
            "remain_distance":1000
        },
        "order_id":"123456754"
    }
}

验签示例

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

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部