Location/route
Zhangchao2 (讨论 | 贡献) (→是否需要登录) |
Zhangchao2 (讨论 | 贡献) (→返回结果) |
||
(未显示1个用户的3个中间版本) | |||
第18行: | 第18行: | ||
===请求参数=== | ===请求参数=== | ||
+ | 选填参数 | ||
*city1(city2):起(终)点所在城市代码,默认为0010(北京) | *city1(city2):起(终)点所在城市代码,默认为0010(北京) | ||
:o 示例: http://api.map.sina.com.cn/i/route.php?city1=0010&city2=0021 | :o 示例: http://api.map.sina.com.cn/i/route.php?city1=0010&city2=0021 | ||
− | |||
− | |||
− | |||
− | |||
*t: 查询类型(0:速度优先,1:费用优先,2:距离优先) | *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 | :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示例:(\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 version="1.0" encoding="utf-8" ?> | ||
<xml> | <xml> | ||
第78行: | 第127行: | ||
=== 使用示例=== | === 使用示例=== | ||
需修改appkey | 需修改appkey | ||
− | *xml: | + | *xml: http://api.map.sina.com.cn/i/route.php?beginxy=116.35442,39.88904&endxy=116.34171,39.58904&source=appkey |
2010年7月7日 (三) 14:11的最后版本
目录 |
Location/route
驾车路线查询接口。
URL
http://api.map.sina.com.cn/i/route.php
格式
xml
HTTP请求方式
GET
是否需要登录
false
请求数限制
true
请求参数
选填参数
- city1(city2):起(终)点所在城市代码,默认为0010(北京)
- t: 查询类型(0:速度优先,1:费用优先,2:距离优先)
以下参数至少填一个
- begin_id: 起点的id(必须与city1结合使用,会覆盖beginxy)
- beginxy: 起点的坐标(逗号分隔,若有id以id为准)
以下参数至少填一个
- end_id: 终点的id(必须与city2结合使用,会覆盖endxy)
- endxy:终点的坐标(逗号分隔,若有id以id为准)
返回结果
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
文档更新时间: 2010-07-07