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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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>

异常示例

  • 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

FAQ

返回
顶部