高德地图路径规划提供步行、公交、驾车查询接口。 示例代码: //载入方法一 $direction = apibus::init("direction"); /* //载入方法二 $api = new apibus(); $direction = $api->load("direction"); */ $key = '用户Key'; //$direction->amapwalking($key,$origin,$destination,$multipath=0,$output='json',$callback=null,$src='SAE'); $ret = $direction->amapwalking($key,'116.434307,39.90909','116.434446,39.90816'); //var_dump($ret); //$direction-> amapintegrated($key,$origin,$destination,$city,$strategy=0,$nightflag=0,$output='json',$callback=null,$src='SAE'); $ret = $direction-> amapintegrated($key,'116.481499,39.990475','116.465063,39.999538','010'); //var_dump($ret); //$direction->amapdriving($key,$origin,$destination,$strategy=0,$extensions='base',$output='json',$originid=null,$destinationid=null,$waypoints=null,$avoidpolygons=null,$avoidroad=null,$callback=null,$src='SAE'); $ret = $direction->amapdriving($key,'116.481499,39.990475','116.465063,39.999538'); var_dump($ret);
- 分类:第三方服务
- 官方网站:
http://api.amap.com
Methods
amapwalking(GET)
参数
keyString
- 用户唯一标识,在高德地图官网申请,申请地址:http://api.amap.com/key/register
originString
- 出发点。经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。
destinationString
- 目的地。经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。
multipathString
- 是否提供备选步行方案。0:只提供一条步行方案;1:提供备选步行方案(有可能无备选方案)。默认值:0
outputString
- 返回数据格式类型,可选值:json,xml
callbackString
- 回调函数,callback值是用户定义的函数名称,此参数只在output=json时有效
srcString
- 新浪sdk标识,值为:SAE
返回
返回示例
status 返回结果状态值,值为0或1,0表示请求失败;1表示请求成功 info 返回状态说明,status为0时,info返回错误原因,否则返回“OK” count 返回结果数目。 route 路线信息列表 origin 起点坐标 destination终点坐标 paths 步行方案 path 步行方案信息 distance 起点和终点的步行距离,单位:米 duration 步行时间预计,单位:秒 steps 返回步行结果列表 step 每段步行方案 instruction 路段步行指示 road 道路名称 distance 此路段距离 orientation 方向 duration 此路段预计步行时间 polyline 此路段坐标点 action 步行主要动作,详情见步行动作列表 assistant_action步行辅助动作,详情见步行动作列表 主要动作列表 辅助动作列表 无基本导航动作 无辅助导航动作 左转 左转 右转 右转 向左前方 向左前方 向右前方 向右前方 向左后方 向左后方 向右后方 向右后方 直行 往后走 靠左 往前走 靠右 靠左 通过人行横道 靠右 通过过街天桥 通过人行横道 通过地下通道 通过过街天桥 通过广场 通过地下通道 到道路斜对面 通过广场 到达目的地 进入右侧道路 进入左侧道路
举例:["status value","count value","info value"]
错误返回示例
INVALID_USER_KEY 用户key非法或过期 SERVICE_NOT_EXIST 请求服务不存在 SERVICE_RESPONSE_ERROR 请求服务响应错误 INSUFFICIENT_PRIVILEGES 无权限访问此服务 OVER_QUOTA 请求超出配额 INVALID_PARAMS 请求参数非法 UNKNOWN_ERROR 未知错误
举例{"info":"info value"}
amapintegrated(GET)
参数
keyString
- 用户唯一标识,在高德地图官网申请,申请地址:http://api.amap.com/key/register
originString
- 出发点。经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。
destinationString
- 目的地。经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。
cityString
- 城市参数,目前只支持市内公交换乘。
strategyString
- 换乘策略。 可选值: 最快捷模式:0 最经济模式:1 最少换乘模式:2 最少步行模式:3 最舒适模式:4 不乘地铁模式:5 默认值:0
nightflagString
- 是否计算夜班车 可选值: 0,不计算夜班车 1,计算夜班车 默认值:0
outputString
- 返回数据格式类型,可选值:json,xml
callbackString
- 回调函数,callback值是用户定义的函数名称,此参数只在output=json时有效
srcString
- 新浪sdk标识,值为:SAE
返回
返回示例
status 返回结果状态值,值为0或1,0表示请求失败;1表示请求成功 info 返回状态说明,status为0时,info返回错误原因,否则返回“OK” count 公交换乘方案数目 route 公交换乘信息列表 origin 起点坐标 destination 终点坐标 distance 起点到终点曼哈顿距离,单位:米 taxi_cost 出租车费用,单位:元 transits 公交换乘方案列表 transit 公交换乘方案 cost 此换乘方案价格,单位:元 duration 此换乘方案预期时间 nightflag 是否是夜班车,1表示是夜班车 walking_distance此方案总步行距离,单位:米 segments 换乘路段列表 walking 此路段步行导航信息列表 bus 此路段公交导航信息列表 entrance地铁入口,只在地铁路段有值。入口信息列表 exit 地铁出口,只在地铁路段有值。出口信息列表 步行导航信息列表:walking origin 起点坐标 destination 终点坐标 distance 起点和终点的步行距离 duration 步行时间预计 steps 步行路段列表 step 步行路段信息 instruction 路段步行指示 road 道路名称 distance 此路段距离,单位:米 duration 此路段预计步行时间,单位:秒 polyline 此路段坐标点 action 步行主要动作 assistant_action步行辅助动作 公交导航信息列表:bus buslines 步行路段列表 busline 步行路段信息 departure_stop 此段起乘站 arrival_stop 此段下车站 name 公交路线名称 id 公交路线id type 公交类型 distance 公交行驶距离 duration 公交预计行驶时间 polyline 此路段坐标集 start_time 首班车时间 end_time 末班车时间 via_num 此段途经公交站数 via_stops 此段途经公交站点列表 stop 途径公交站点信息 name 公交站点名称 id 公交站id location公交站点经纬度 入口信息列表:entrance name 入口名称 location入口经纬度 出口信息列表:exit name 出口名称 location出口经纬度
举例:["status value","count value","info value"]
错误返回示例
INVALID_USER_KEY 用户key非法或过期 SERVICE_NOT_EXIST 请求服务不存在 SERVICE_RESPONSE_ERROR 请求服务响应错误 INSUFFICIENT_PRIVILEGES 无权限访问此服务 OVER_QUOTA 请求超出配额 INVALID_PARAMS 请求参数非法 UNKNOWN_ERROR 未知错误
举例["info value"]
amapdriving(GET)
参数
keyString
- 用户唯一标识,在高德地图官网申请,申请地址:http://api.amap.com/key/register
originString
- 出发点。经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。
destinationString
- 目的地。经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。
strategyString
- 驾车选择策略: 0速度优先(时间) 1费用优先(不走收费路段的最快道路) 2距离优先 3不走快速路 4躲避拥堵 5多策略(同时使用速度优先、费用优先、距离优先三个策略计算路径) 6不走高速 7不走高速且避免收费 8躲避收费和拥堵 9不走高速且躲避收费和拥堵 默认值:0
extensionsString
- 返回结果控制。取值为base,返回基本驾车导航信息;取值为all,返回基本+详细信息。默认值:base
outputString
- 返回数据格式类型,可选值:json,xml
originidString
- 出发点poiid。当起点为POI时,建议填充此值。
destinationidString
- 目的地poiid。当终点为POI时,建议填充此值。
waypointsString
- 途经点。经度和纬度用","分割,经度在前,纬度在后,小数点后不超过6位,坐标点之间用";"分隔。支持最大点数:16个
avoidpolygonsString
- 避让区域。支持32个避让区域,每个区域最多可有16个顶点。 经度和纬度用","分割,经度在前,纬度在后,小数点后不超过6位,坐标点之间用";"分隔,区域之间用"|"分隔。如果是四边形则有四个坐标点,如果是五边形则有五个坐标点。
avoidroadString
- 避让道路名,只支持一条避让道路。
callbackString
- 回调函数,callback值是用户定义的函数名称,此参数只在output=json时有效
srcString
- 新浪sdk标识,值为:SAE
返回
返回示例
status 返回结果状态值,值为0或1,0表示请求失败;1表示请求成功 info 返回状态说明,status为0时,info返回错误原因,否则返回“OK” count 驾车路径规划方案数目 route 驾车路径规划信息列表 origin 起点坐标 destination 终点坐标 paths 驾车方案列表 path 驾车换乘方案 distance 行驶距离,单位:米 duration 预计行驶时间,单位:秒 strategy 导航策略 tolls 此导航方案道路收费,单位:元 toll_distance 收费路段距离 steps 导航路段 step 导航路段信息step列表 导航路段信息step列表 instruction 行驶指示 orientation 方向 road 道路名称 distance 此路段距离 tolls 此段收费 toll_distance 收费路段距离 toll_road 主要收费道路 duration 此路段预计时间 polyline 此路段坐标点串 action 导航主要动作,详见驾车动作列表 assistant_action导航辅助动作,详见驾车动作列表 extensions=all时返回以下信息 cities 途径城市列表 city 途径城市信息 name 城市名称 citycode城市代码 adcode 城市编码 districts 途径行政区列表 district途径行政区信息 name 行政区名称 adcode 行政区编码 tmcs 路况信息列表 lcode 路况信息对应的路段ID distance此locationcode对应的路段长度 status 路况状态,0:未知,1:畅通,2:缓行,3:拥堵 驾车主要动作列表 无基本导航动作 左转 右转 向左前方行驶 向右前方行驶 向左后方行驶 向右后方行驶 左转调头 直行 靠左 靠右 进入环岛 离开环岛 减速行驶 插入直行 驾车辅助动作列表: 辅助动作列表 辅助动作列表 辅助动作列表 无辅助导航动作 靠右行驶进入右转专用道 到达复杂路口,走右边第三出口 进入主路 进入轮渡 到达复杂路口,走右边第四出口 进入辅路 驶离轮渡 到达复杂路口,走左边第一出口 进入高速 沿当前道路行驶 到达复杂路口,走左边第二出口 进入匝道 沿辅路行驶 到达复杂路口,走左边第三出口 进入隧道 沿主路行驶 到达复杂路口,走左边第四出口 进入中间岔道 到达出口 到达复杂路口,走左边第五出口 进入右岔路 到达服务区 进入左岔路 到达收费站 进入右转专用道 到达途经地 进入左转专用道 到达目的地的 进入中间道路 绕环岛左转 进入右侧道路 绕环岛右转 进入左侧道路 绕环岛直行 靠右行驶进入辅路 绕环岛右转 靠左行驶进入辅路 小环岛不数出口 靠右行驶进入主路 到达复杂路口,走右边第一出口 靠左行驶进入主路 到达复杂路口,走右边第二出口
举例:["status value","count value","info value"]
错误返回示例
INVALID_USER_KEY 用户key非法或过期 SERVICE_NOT_EXIST 请求服务不存在 SERVICE_RESPONSE_ERROR 请求服务响应错误 INSUFFICIENT_PRIVILEGES 无权限访问此服务 OVER_QUOTA 请求超出配额 INVALID_PARAMS 请求参数非法 UNKNOWN_ERROR 未知错误
举例["info value"]