驾车路线查询

根据ID或坐标等进行查询，返回驾车路线信息

URL

http://api.t.sina.com.cn/navigation/route.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

GET

是否需要登录

false

请求数限制

true

请求参数

返回结果

XML示例

<xml>
  <status>1</status> 
  <type>0</type> 
  <total>9</total> 
  <time>22</time> 
  <distance>14328</distance> 
  <drive_coordinates>116.27505,40.00236;116.27502,40.00248;......</drive_coordinates> 
  <pass_coordinates /> 
  <start_coordinate>116.27505,40.00236</start_coordinate> 
  <end_coordinate>116.20006,39.9325</end_coordinate> 
  <extension_info>0</extension_info> 
  <list>
  <item>
   <rid>1</rid> 
   <road_name>颐和园路</road_name> 
   <coordinates>116.27505,40.00236;116.27502,40.00248;......</coordinates> 
   <begin_coordinate>116.27505,40.00236</begin_coordinate> 
   <end_coordinate>116.26902,40.00884</end_coordinate> 
   <road_length>953</road_length> 
   <action /> 
   <road_sign>行驶时间;等级方向;坐标点;道路名称;</road_sign> 
   <run_time>1</run_time> 
   <grade>主要道路</grade> 
   <direction>西北</direction> 
   <assist_info /> 
   <navigation_tag /> 
  </item>
  .
  .
  .
</xml>

JSON示例

{
 "status":"1",
 "type":0,
 "total":"9",
 "time":"22",
 "distance":"14328",
 "drive_coordinates":"116.27505,40.00236;116.27502,40.00248;......",
 "pass_coordinates":"",
 "start_coordinate":"116.27505,40.00236",
 "end_coordinate":"116.20006,39.9325",
 "extension_info":"0",
 "list":[{
          "rid":"1",
          "road_name":"\u9890\u548c\u56ed\u8def",
          "coordinates":"116.27505,40.00236;116.27502,40.00248;......",
          "begin_coordinate":"116.27505,40.00236",
          "end_coordinate":"116.26902,40.00884",
          "road_length":"953",
          "action":null,
          "road_sign":"\u884c\u9a76\u65f6\u95f4;\u7b49\u7ea7\u65b9\u5411;\u5750\u6807\u70b9;\u9053\u8def\u540d\u79f0;",
          "run_time":"1",
          "grade":"\u4e3b\u8981\u9053\u8def",
          "direction":"\u897f\u5317",
          "assist_info":null,"navigation_tag":null
          },
          ......
        ]
}

字段说明

list节点：该节点包含n个item节点

rid表示当前路段的id，是标识该路段。

road_length：表示当前路段的长度；

road_sign：道路标识；

run_time：在该路段运行时间；

grade：标识主要道路或次要道路等；

direction：标识当前路段后，向哪个方向行驶，如向“东”行行驶；

road_name：当前路段名称；如北四环西路辅路

coordinates：当前道路坐标信息；

action：当前行驶动作，如“右转”进入...向...行驶；标识右转动作

assist_info：标识当前是否有无辅助动作，是对action的一个补充；如右转后，到达出口再进入...向...行驶。 这里的“到达出口”即为辅助动作，如果没有辅助动作该标签内容为“无辅助动作”。又如“到达收费站”也为辅助动作；

navigation_tag ：导航标签；

begin_coordinate：该路段的第一个坐标；

end_coordinate：该路段的最后的一个坐标；

staus:返回结果状态，0

extension_info：当前返回状态补充信息；

pass_coordinates：途经点坐标；

total：此次驾车路线所经过的路段总数；:distance：驾车距离；

time：驾车时间；

drive_coordinates：驾车路线坐标；

start_coordinate：起点坐标；

extension_info：终点坐标；:type：标识当前的结果是距离优先、速度优先，费用优先

使用示例

xml: 
http://api.t.sina.com.cn/navigation/route.xml?begin_id=P010A00CHR9&end_id=P010A00CWWJ&source=appkey

json: 
http://api.t.sina.com.cn/navigation/route.json?begin_id=P010A00CHR9&end_id=P010A00CWWJ&source=appkey