Location/route

跳转到: 导航, 搜索

目录

Location/route

驾车路线查询接口。

URL

http://api.map.sina.com.cn/i/route.php

格式

xml

HTTP请求方式

GET

是否需要登录

false

请求数限制

true

请求参数

选填参数

  • city1(city2):起(终)点所在城市代码,默认为0010(北京)
o 示例: http://api.map.sina.com.cn/i/route.php?city1=0010&city2=0021
  • t: 查询类型(0:速度优先,1:费用优先,2:距离优先)
o 示例: http://api.map.sina.com.cn/i/route.php?city1=0010&city2=0021&begin_id=46727&end_id=5000&t=1

以下参数至少填一个

  • begin_id: 起点的id(必须与city1结合使用,会覆盖beginxy)
o 示例: http://api.map.sina.com.cn/i/route.php?city1=0010&city2=0021&begin_id=46727&end_id=5000
  • beginxy: 起点的坐标(逗号分隔,若有id以id为准)
o 示例: http://api.map.sina.com.cn/i/route.php?beginxy=116.35442,39.88904&endxy=116.34171,39.58904

以下参数至少填一个

  • end_id: 终点的id(必须与city2结合使用,会覆盖endxy)
o 示例: http://api.map.sina.com.cn/i/route.php?city1=0010&city2=0021&begin_id=46727&end_id=5000
  • endxy:终点的坐标(逗号分隔,若有id以id为准)
o 示例: http://api.map.sina.com.cn/i/route.php?beginxy=116.35442,39.88904&endxy=116.34171,39.58904

返回结果

XML示例:(\P 标签 在实际返回结果中为 P 标签)

标签说明:
XML:结果页根节点;
 List节点:该节点包含n个item节点,;
  item节点:
  <seg_id>1</seg_id>
  <seg_Length>24</seg_Length>
  <roadSign>行驶时间;等级方向;坐标点;道路名称;</roadSign>
  <sTime>1</sTime>
  <sGrade>主要道路</sGrade>
  <sDirection>东</sDirection>
  <roadName>北四环西路辅路</roadName>
  <segline>11630921,3998503;11630933,3998504;11630951,3998505</segline>
  <action>右转</action>
  <accessInfo/>
  <navSign/>
  <\P>11630921,3998503</\P>
  <next>11630951,3998505</next>
   Seg_id表示当前路段的id,是标识该路段。
   Seg_Length:表示当前路段的长度;
   roadSign:道路标识;
  sTime:在该路段运行时间;
  sGrade:标识主要道路或次要道路等;
  sDirection:标识当前路段后,向哪个方向行驶,如向“东”行行驶;
  roadName:当前路段名称;如北四环西路辅路
  segline:当前道路坐标信息;
  action:当前行驶动作,如“右转”进入。。。。。。向。。。。行驶;标识右转动作
  acessInfo:标识当前是否有无辅助动作,是对action的一个补充;如右转后,到达出口再进入。。。。向。。。。行驶。 这里的“到达出口”即为辅助动作,如果没有辅助动作,,中该标签内容为“无辅助动作”。又如“到达收费站”也为辅助动作;
  navSign:导航标签;
  P :该路段的第一个坐标;
  Next:该路段的最后的一个坐标;
  statusInfo:当前返回状态补充信息;
  midsxy:途经点坐标;
  total:此次驾车路线所经过的路段总数;
  segNum:路段总数;
  distance:驾车距离;
  time:驾车时间;
  pathstr:驾车路线坐标;
  startxy:起点坐标;
  endxy:终点坐标;
  result:标识结果;如该值为0,则没有找到相关的驾车路线信息;
  type:标识当前的结果是距离优先、速度优先,费用优先
<?xml version="1.0" encoding="utf-8" ?> 
<xml>
<list>
<item>
 <seg_id>1</seg_id> 
 <seg_Length>34</seg_Length> 
 <roadSign>行驶时间;等级方向;坐标点;</roadSign> 
 <sTime>1</sTime> 
 <sGrade>主要道路</sGrade> 
 <sDirection>南</sDirection> 
 <roadName>吉市口路</roadName> 
 <segline>116.43755,39.92733;116.43757,39.92702</segline> 
 <action /> 
 <accessInfo /> 
 <navSign /> 
 <\P>116.43755,39.92733</\P> 
 <next>116.43757,39.92702</next> 
</item>
<item>
 <seg_id>2</seg_id> 
 <seg_Length>250</seg_Length> 
 <roadSign>行驶时间;等级方向;坐标点;道路名称;</roadSign> 
 <sTime>1</sTime> 
 <sGrade>主要道路</sGrade> 
 <sDirection>西</sDirection> 
 <roadName /> 
 <segline>116.43757,39.92702;116.43757,39.92702;116.43704,39.92703;116.43463,39.92709</segline> 
 <action>右转</action> 
 <accessInfo>无辅助动作</accessInfo> 
 <navSign /> 
 <\P>116.43757,39.92702</\P> 
 <next>116.43463,39.92709</next> 
</item>
</list>
 <statusInfo>0</statusInfo> 
 <midsxy /> 
 <total>11</total> 
 <segNum>11</segNum> 
 <distance>26296</distance> 
 <time>30</time> 
 <pathstr>116.43755,39.92733;116.43757,39.92702;116.43757,39.92702;……</pathstr> 
 <startxy>116.43755,39.92733</startxy> 
 <endxy>116.19215,39.92640</endxy> 
 <result>1</result> 
 <type>0</type> 
</xml>

使用示例

需修改appkey