路径规划

使用服务 下载SDK: php

高德地图路径规划提供步行、公交、驾车查询接口

高德地图路径规划提供步行、公交、驾车查询接口。
示例代码:
//载入方法一
$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);

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"]