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

alibaba.amap.channel.car.navigation.query (路线规划)

路线规划

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
trace_id String 可选 6d684a10-873a-5c84-878c-161f15923200 请求唯一ID
client_source String 必须 amap_car 渠道来源,高德分配
start_location Location 必须 起点信息
  • └ lon
  • String
  • 必须
  • 116.473253
  • 经度
  • └ lat
  • String
  • 必须
  • 39.993952
  • 纬度
  • └ name
  • String
  • 可选
  • 首开广场(西北一门)
  • 名称
end_location Location 必须 终点信息
  • └ lon
  • String
  • 必须
  • 116.347328
  • 经度
  • └ lat
  • String
  • 必须
  • 40.060039
  • 纬度
  • └ name
  • String
  • 可选
  • 育新(地铁站)
  • 名称
platform String 可选 android 手机设备 ios/android
imei String 可选 6d684a10-873a-5c84-878c-161f15923200 android设备唯一标示
idfa String 可选 6d684a10-873a-5c84-878c-161f15923200 ios设备唯一标示
diu String 可选 6d684a10-873a-5c84-878c-161f15923200 设备号

响应参数

名称 类型 示例值 描述
trace_id String 6d684a10-873a-5c84-878c-161f15923200 请求唯一iD
result_code String 0 结果码
result_msg String success 结果码描述
points String [] ["116.35759,40.045532","116.35762,40.04554"] 路线经纬度集合
cost_time String 972 预估耗时 单位秒
distance String 5951 距离 单位米
traffic_status String [] [ "3,0,0,0", "3,28,0,0" ] 路况信息,3绿色 4黄色 5红色 6深红

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAmapChannelCarNavigationQueryRequest req = new AlibabaAmapChannelCarNavigationQueryRequest();
req.setTraceId("6d684a10-873a-5c84-878c-161f15923200");
req.setClientSource("amap_car");
AlibabaAmapChannelCarNavigationQueryRequest.Location obj1 = new AlibabaAmapChannelCarNavigationQueryRequest.Location();
obj1.setLon("116.473253");
obj1.setLat("39.993952");
obj1.setName("首开广场(西北一门)");
req.setStartLocation(obj1);
AlibabaAmapChannelCarNavigationQueryRequest.Location obj2 = new AlibabaAmapChannelCarNavigationQueryRequest.Location();
obj2.setLon("116.347328");
obj2.setLat("40.060039");
obj2.setName("育新(地铁站)");
req.setEndLocation(obj2);
req.setPlatform("android");
req.setImei("6d684a10-873a-5c84-878c-161f15923200");
req.setIdfa("6d684a10-873a-5c84-878c-161f15923200");
req.setDiu("6d684a10-873a-5c84-878c-161f15923200");
AlibabaAmapChannelCarNavigationQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_amap_channel_car_navigation_query_response>
    <trace_id>6d684a10-873a-5c84-878c-161f15923200</trace_id>
    <result_code>0</result_code>
    <result_msg>success</result_msg>
    <points>
        <string>[&quot;116.35759</string>
        <string>40.045532&quot;</string>
        <string>&quot;116.35762</string>
        <string>40.04554&quot;]</string>
    </points>
    <cost_time>972</cost_time>
    <distance>5951</distance>
    <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>
</alibaba_amap_channel_car_navigation_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部