百度地图开放平台

所有文档

行程分享

服务概览

快速开始

使用准备

接口文档

服务功能

乘客拉取路线

相关资料

更新日志
更新时间: 2026/11/02 10:47
乘客拉取路线
接口说明

乘客端拉取司机端实时行程的接口,需配合司乘同显SDK使用,适用于乘客在 Web 端 / JS 端拉取并展示司机端的导航路线。接口支持:
1. 按订单拉取司机实时位置点及绑路后的坐标、方向
2. 拉取主路线及其形状点、路况,途经点信息
3. 拉取备选路线及其路况
4. 通过 pull_type 按位控制需要拉取的内容,并通过路线、路况指纹实现增量下发

API服务地址

https://api.map.baidu.com/tripshare/v1/thdpsg/pullpath?company=您的厂商&status=1&original_order_id=您的订单号&ak=您的AK
//GET请求

请求参数
字段名类型描述必填示例备注

ak

string

开发者密钥,AK申请

是

company

string

厂商名称

是

status

int

订单状态

是

original_order_id

string

原始订单ID

是

trip_mode

string

出行方式

否

默认:driving

req_src

string

请求来源

否

如果req_src不是sctx_sdk,必须传入original_order_id,服务默认值为web

pull_type

int

拉取内容类型

否

按位控制拉取内容,默认只拉取司机位置点(4)

&1:主路线

&2:主路线路况

&4:司机位置点

&8:主路线剩余距离和时间

&16:其他路线剩余距离和时间

&32:其他路线

&64:其他路线路况

route_finger

string

当前主路线的指纹

否

指纹未变化时不重复下发路线数据

traffic_finger

string

当前主路线路况的指纹

否

other_route_fingers

string

其他路线的指纹

否

多个路线的指纹之间用英文逗号分隔

other_traffic_fingers

string

其他路线的路况指纹

否

多个路况指纹之间用英文逗号分隔

order_type

int

订单类型

否

默认值:0,普通订单

coord_type

string

返回坐标系类型

否

可选:bd09ll(默认)、bd09mc、gcj02、wgs84

cuid

string

设备标识

否

返回参数
字段名类型描述

status

int

状态码

message

string

状态码对应的信息

data

object

乘客拉取到的行程信息

s

int

订单状态

mtime

int

订单信息最近编辑时间

remain

string

主路线的剩余距离和剩余时间,pull_type & 8 > 0 时返回

other_remains

array

其他路线的剩余距离和剩余时间,pull_type & 16 > 0 时返回

route_id

string

路线md5

remain

string

剩余距离和剩余时间

run

string

直接返回 0,0(无意义)

positions

array

司机位置点,实际只返回司机最新的一个点,pull_type & 4 > 0 时返回

t

int

时间戳

p

string

司机坐标

session_id

string

session_id

route

object

主路线,pull_type & 1 > 0 时返回

mrsl

string

mrsl

route_id

string

路线md5

c

int

如果为1,标识路线发生变更

f

string

路线finger

d

string

路线形状点序列,finger变化才会返回

s

string

路线sections,finger变化才会返回

transport_mode

int

交通方式,finger变化才会返回

s_point

string

普通订单接乘客阶段,起点有变更才会返回,finger变化才会返回

e_point

string

普通订单送乘客阶段,终点有变更才会返回,finger变化才会返回

w

object

途经点

w.o

string

原始订单号

w.p

string

途经点坐标点

w.n

string

途经点名称

w.i

string

途经点的poi唯一id

w.t

string

途经点的类型(start/end/way)

w.s

int

途经点状态,3:路线更新前已走过,1:走过,0:没走过

w.sec_idx

int

途经点的索引

w.remain

string

途经点剩余距离剩余时间

pt_idx

int

司机位置点在路线上的索引,如果司机正好在两个点中间,取前一个点的索引

pt

string

司机的绑路坐标点

dir

int

司机位置的绑路后方向

other_routes

array

其他路线,pull_type & 32 > 0 时返回

mrsl

string

mrsl

route_id

string

路线md5

c

int

如果为1,标识路线发生变更

f

string

路线finger

d

string

路线形状点序列,finger变化才会返回

s

string

路线sections,finger变化才会返回

transport_mode

int

交通方式,finger变化才会返回

pt_idx

int

司机位置点在路线上的索引

pt

string

司机的绑路坐标点

dir

int

司机位置的绑路后方向

traffic

object

主路线的路况,pull_type & 2 > 0 时返回

c

int

路况是否变化

f

string

主路线路况的finger

d

string

主路线的路况数据

other_traffic

array

其他路线的路况,pull_type & 64 > 0 时返回

route_id

string

路线md5

c

int

路况是否变化

f

string

路况的finger

d

string

路线的路况数据

上一篇

使用准备

下一篇

更新日志
本篇文章对您是否有帮助?