驾车规划
1 服务介绍
驾车服务API是一类简单的HTTP/HTTPS接口,根据输入起点、终点和途经点规划查询驾车路线。
2 参数说明
根据输入的起点、终点和途径点规划查询驾车路线。
输入的参数如下:
参数 | 参数说明 | 参数类型 | 返回条件 | 备注 |
orig | string | 起点经纬度 | 是 | -180,-90,180,90。 |
dest | string | 终点经纬度 | 是 | -180,-90,180,90。 |
mid | string | 途径点经纬度字符串 | 否 | 途径点字符串格式:116.35506,39.92277;116.35506,39.92277两个坐标之间以分号隔开,坐标xy之间用逗号隔开(都是半角)。 |
style | string | 导航路线类型 | 默认0 (0:最快路线,1:最短路线,2:避开高速,3:步行) | 0-3。 |
3 请求示例
根据起点、终点经纬度字符串查询导航信息:http://ip:port/drive?postStr={"orig":"116.35506,39.92277","dest":"116.39751,39.90854","style":"0"}&type=search&tk=您的密钥
加入途径点的导航查询:http://ip:port/drive?postStr={"orig":"116.35506,39.92277","dest":"116.39751,39.90854","mid":"116.36506,39.91277;116.37506,39.92077","style":"0"}&type=search&tk=您的密钥
4 规划结果
<?xml version="1.0" encoding="UTF-8" ?>
<result orig='起点经纬度' mid='途径点信息' dest='终点经纬度'>
<parameters>
<orig>起点加密经纬度</orig>
<dest>终点加密经纬度</dest>
<mid>途径点加密经纬度集合</mid>
<key>经纬度加密的 key 值</key>
<width>地图宽度</width>
<height>地图高度</height>
<style>导航路线类型</style>
<version>版本控制</version>
<sort>排序方式</sort>
</parameters>
<routes count='分段总数' time='查询时间'>
<item id='0'>
<strguide>每段线路文字描述</strguide>
<signage>“路牌”引导提示/高速路收费站出口信息</signage>
<streetName>当前路段名称</streetName>
<nextStreetName>下一段道路名称</nextStreetName>
<tollStatus>道路收费信息(0=免费路段,1=收费路段,2=部分收费路段)</tollStatus>
<turnlatlon>转折点经纬度</turnlatlon>
</item>
<item id='1'>
....
</item>
....其他分段线路信息
</routes>
<simple>
<item id='0'>
<strguide>每段线路文字描述</strguide>
<streetNames>当前行驶路段名称(含多个路段)</streetNames>
<lastStreetName>最后一段道路名称</lastStreetName>
<linkStreetName>合并段之间衔接的道路名称</linkStreetName>
<signage>“路牌”引导提示/高速路收费站出口信息</signage>
<tollStatus>道路收费信息(0=免费路段,1=收费路段,2=部分收费路段)</tollStatus>
<turnlatlon>转折点经纬度</turnlatlon>
<streetLatLon>线路经纬度</streetLatLon>
<streetDistance>行驶总距离(单位:米)</streetDistance>
<segmentNumber>合并后的号段,对应详细描述中的号段</segmentNumber>
</item>
<item id='1'>
....
</item>
....其他分段线路信息
</simple>
<distance>全长(单位:公里)</distance>
<duration>行驶总时间(单位:秒)</duration>
<routelatlon>线路经纬度字符串</routelatlon>
<mapinfo>
<center>全部结果同时显示的适宜中心经纬度</center>
<scale>全部结果同时显示的适宜缩放比例</scale>
</mapinfo>
</result>