文档中心 > API类目 > 阿里高德打车API

alibaba.amap.channel.car.driver.location.query (司机轨迹)

获取司机轨迹 1.包含司机真实位置经纬度 2.当订单处于接单,但未开始服务时,返回接驾轨迹经纬度集合 3.当订单处于开始服务时,返回送驾轨迹经纬度集合 4.预约单距离行程时间半小时内才会返回司机路线位置信息 5.只有司机接单、司机到达、司机开始服务可以调用该接口关于routeTime算路时间说明为降低交互数据量,在需要司机路线时,routeTime第一次传null,之后传上一次的返回值的routeTime,以保证在司机路线没有变化的时候,不再返回司机路线,接入端需自行保存算路数据关于syncId syncId作为请求标记，需要获取插帧数据的情况必传，我们将司机数据分为若干区间，syncID标识的是司机数据的区间下标，接入方需要将上一次请求的获得的syncId在下一次请求时透传回来，以获取下一段数据。第一次请求请传0

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
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。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	描述
trace_id	String	可选	6d684a10-873a-5c84-878c-161f15923200	请求唯一ID
amap_order_id	String	必须	1541894302897424029	高德订单号
channel_order_id	String	可选	1541894302897	渠道订单号(接入公司自定义)
client_source	String	必须	amap-car	渠道来源,高德分配
need_route	Boolean	可选	true	默认false, 不需要路线
passenger_lat	String	可选	39.993967	乘客纬度
passenger_lng	String	可选	116.473225	乘客经度
route_time	Number	可选	1600087832858	算路时间,需要路线时,第一次传null,以后传上一次返回的routeTime
sync_id	Number	可选	28	司机数据段下标

响应参数

名称	类型	示例值	描述
trace_id	String	6d684a10-873a-5c84-878c-161f15923200	请求唯一ID
result_code	String	0	状态码
result_msg	String	Success	状态码描述
amap_order_id	String	1541894302897424029	高德订单号
channel_order_id	String	1541894302897	渠道订单号(接入公司自定义)
lat	String	40.002813	司机纬度
lng	String	116.473225	司机经度
points	String []	[ "116.473225,39.993963","116.473251,39.99395"]	路线,订单状态为接单则为接驾路线;订单状态为行程中,则为行程路线;配合算路时间,一般路线不变则只返回一次
route_time	Number	1600087832858	算路时间
frame_info	RouteFrameInfo		系统自动生成
└ duration Number 5000 默认为5000毫秒,即返回5秒的司机插帧数据 frame_list Frame [] 插帧数据 └ course String 358.69647216796875 司机方向，正北为0°，顺时针方向 └ lat String 39.993963","116.473251,39.99395 司机纬度 └ lng String 116.473225 司机经度 └ percent_remain String 0.1 距离下一个离散点的百分比 └ current_index Number 1 当前处于points离散点的下标位置
sync_id	Number	28	司机数据段下标,下次请求需要透传回去
traffic_status	String []	[ "3,0,0,0", "3,28,0,0" ]	路况信息,3绿色 4黄色 5红色 6深红
distance	Number	67888	预估里程,单位米
travel_time	Number	2600	预估时长，单位 ms

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAmapChannelCarDriverLocationQueryRequest req = new AlibabaAmapChannelCarDriverLocationQueryRequest();
req.setTraceId("6d684a10-873a-5c84-878c-161f15923200");
req.setAmapOrderId("1541894302897424029");
req.setChannelOrderId("1541894302897");
req.setClientSource("amap-car");
req.setNeedRoute(true);
req.setPassengerLat("39.993967");
req.setPassengerLng("116.473225");
req.setRouteTime(1600087832858L);
req.setSyncId(28L);
AlibabaAmapChannelCarDriverLocationQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<alibaba_amap_channel_car_driver_location_query_response>
    <trace_id>6d684a10-873a-5c84-878c-161f15923200</trace_id>
    <result_code>0</result_code>
    <result_msg>Success</result_msg>
    <amap_order_id>1541894302897424029</amap_order_id>
    <channel_order_id>1541894302897</channel_order_id>
    <lat>40.002813</lat>
    <lng>116.473225</lng>
    <points>
        <string>[ &quot;116.473225</string>
        <string>39.993963&quot;</string>
        <string>&quot;116.473251</string>
        <string>39.99395&quot;]</string>
    </points>
    <route_time>1600087832858</route_time>
    <frame_info>
        <duration>5000</duration>
        <frame_list>
            <frame>
                <course>358.69647216796875</course>
                <lat>39.993963&quot;,&quot;116.473251,39.99395</lat>
                <lng>116.473225</lng>
                <percent_remain>0.1</percent_remain>
                <current_index>1</current_index>
            </frame>
        </frame_list>
    </frame_info>
    <sync_id>28</sync_id>
    <traffic_status>
        <string>[  &quot;3</string>
        <string>0</string>
        <string>0</string>
        <string>0&quot;</string>
        <string>&quot;3</string>
        <string>28</string>
        <string>0</string>
        <string>0&quot; ]</string>
    </traffic_status>
    <distance>67888</distance>
    <travel_time>2600</travel_time>
</alibaba_amap_channel_car_driver_location_query_response>

{
    "alibaba_amap_channel_car_driver_location_query_response":{
        "trace_id":"6d684a10-873a-5c84-878c-161f15923200",
        "result_code":"0",
        "result_msg":"Success",
        "amap_order_id":"1541894302897424029",
        "channel_order_id":"1541894302897",
        "lat":"40.002813",
        "lng":"116.473225",
        "points":{
            "string":[
                "[ \"116.473225",
                "39.993963\"",
                "\"116.473251",
                "39.99395\"]"
            ]
        },
        "route_time":1600087832858,
        "frame_info":{
            "duration":5000,
            "frame_list":{
                "frame":[
                    {
                        "course":"358.69647216796875",
                        "lat":"39.993963\",\"116.473251,39.99395",
                        "lng":"116.473225",
                        "percent_remain":"0.1",
                        "current_index":1
                    }
                ]
            }
        },
        "sync_id":28,
        "traffic_status":{
            "string":[
                "[  \"3",
                "0",
                "0",
                "0\"",
                "  \"3",
                "28",
                "0",
                "0\" ]"
            ]
        },
        "distance":67888,
        "travel_time":2600
    }
}

异常示例

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码	错误描述	解决方案
isp.http-connection-timeout
isp.http-read-timeout

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

阿里高德打车API