高德地图 JS API—参考手册路径规划

高德地图 JS API—参考手册路径规划

名称说明是否插件
AMap.Driving驾车路线规划服务,提供可带途经点的起点、终点的驾车导航路线查询功能
AMap.TruckDriving货车路线规划服务,提供可带途经点的起点、终点之间的货车导航路线查询功能
AMap.Transfer公交换乘服务,提供起、终点公交路线规划服务,整合步行方式
AMap.Walking 步行导航服务,提供起、终点步行路线规划服务
AMap.Riding 骑行路径规划服务,提供起、终点骑行路线规划服务
AMap.DragRoute拖拽导航插件
AMap.ArrivalRange公交到达圈展示,提供开发者到达圈类业务的实现思路,根据起点坐标,计算出在指定时间内能够到达的距离范围

AMap.Driving

驾车路线规划服务,提供起、终点坐标的驾车导航路线查询功能。AMap. Driving构造函数的参数为 DrivingOptions 对象。DrivingOptions 允许设置驾车策略和返回信息详略。用户可以通过自定义回调函数取回并显示查询结果。若服务请求失败,系统将返回错误信息

相关示例

构造函数说明
AMap.Driving(opts:DrivingOptions )构造函数,创建驾车路线规划实例
DrivingOptions类型说明
policyDrivingPolicy驾车路线规划策略
extensionsString默认值:base,返回基本地址信息当取值为:all,返回DriveStep基本信息+DriveStep详细信息
ferryInteger默认为0,表示可以使用轮渡,为1的时候表示不可以使用轮渡
mapMapAMap.Map对象, 展现结果的地图实例。当指定此参数后,搜索结果的标注、线路等均会自动添加到此地图上。可选
panelString|HTMLElement结果列表的HTML容器id或容器元素,提供此参数后,结果列表将在此容器中进行展示。可选
hideMarkersBoolean设置隐藏路径规划的起始点图标,设置为true:隐藏图标;设置false:显示图标                                默认值为:false
showTrafficBoolean设置是否显示实时路况信息,默认设置为true。显示绿色代表畅通,黄色代表轻微拥堵,红色代表比较拥堵,灰色表示无路况信息。
provinceString车牌省份的汉字缩写,用于判断是否限行,与number属性组合使用,可选。例如:京
numberString除省份之外车牌的字母和数字,用于判断限行相关,与province属性组合使用,可选。例如:NH1N11
isOutlineBoolean使用map属性时,绘制的规划线路是否显示描边。缺省为true
outlineColorString使用map属性时,绘制的规划线路的描边颜色。缺省为’white’
autoFitViewBoolean用于控制在路径规划结束后,是否自动调整地图视野使绘制的路线处于视口的可见范围
方法返回值说明
search(origin:LngLat,destination:LngLat,opts:Object,callback:function(status:String,result:info/DrivingResult))或 search(points:Array.<Object>,callback:function(status:String,result:info/DrivingResult))
根据起点、终点和途经点(可选)坐标或名称,实现驾车路线规划,途经点通过opts设定,最多支持16个途径点,opts:{waypoints:Array.<LngLat>};status为complete时,result为DrivingResult;当status为error时,result为错误信息info;当status为no_data时,代表检索返回0结果。注:以名称关键字查询时,points为起点、终点和途经点(可选)名称及对应城市的数组,例如:[{keyword:‘北京南站’,city:‘北京市’},{keyword:‘广东大厦’,city:’北京市’},{ keyword:‘北京西站’,city:‘北京市’}]系统取数组第一个元素和最后一个元素作为起点和终点,中间元素为途经点;
 起终点为经纬度,请使用search(origin:LngLat,destination:LngLat,opts:Object,
callback:function(status:String,result:info/DrivingResult))
起终点为字符串(汉字,比如北京,重庆),请使用search(points:Array.<Object>,
callback:function(status:String,result:info/DrivingResult)) 
setPolicy(policy:DrivingPolicy)
设置驾车路线规划策略
setAvoidPolygons(path:Array.<Array.<LngLat>>)
设置避让区域,最大支持三个避让区域,参数为LngLat的二维数组
setAvoidRoad(road:String)
设置避让道路名称,只支持一条避让道路                    注:避让道路和避让区域不能同时使用
clearAvoidRoad()
清除避让道路
clearAvoidPolygons()
清除避让区域
getAvoidPolygons()
获取避让区域,返回LngLat的二维数组
getAvoidRoad()String获取避让道路
clear()
清除搜索结果
searchOnAMAP(obj:Object)
唤起高德地图客户端驾车路径规划Obj参数形如:{   origin:LngLat,//起点坐标originName: “清华大学”,//起点名称destination:LngLat,//终点坐标destinationName: “首开广场” //终点名称 }
setProvinceAndNumber(province:String,number:String)
设置车牌的汉字首字符和首字后的号码,设置后路线规划的结果将考虑该车牌在当前时间的限行路段
事件参数说明
completeDrivingResult当查询成功时触发此事件
errorErrorStatus当查询失败时触发此事件

驾车策略 

DrivingPolicy类型说明
AMap.DrivingPolicy.LEAST_TIMEConst最快捷模式
AMap.DrivingPolicy.LEAST_FEEConst最经济模式
AMap.DrivingPolicy.LEAST_DISTANCEConst最短距离模式
AMap.DrivingPolicy.REAL_TRAFFICConst考虑实时路况

AMap.TruckDriving

货车路线规划,自v1.4.4新增,构造函数及方法如下,数据返回结果与Driving一致。

构造函数说明
AMap.TruckDriving(opts:TruckDrivingOptions )构造函数,创建驾车路线规划实例
TruckDrivingOptions类型说明
policyInteger路线规划策略,1-9,查看策略详细说明
sizeInteger车型大小,必填,1-4分别对应小型至大型
widthNumber宽度,缺省2.5米
heightNumber高度,缺省1.6米
loadNumber载重,缺省0.9t
weightNumber自重,缺省10t
axlesNumInteger轴数,缺省2轴
extensionsString默认值:base,返回基本地址信息当取值为:all,返回DriveStep基本信息+DriveStep详细信息
mapMapAMap.Map对象, 展现结果的地图实例。当指定此参数后,搜索结果的标注、线路等均会自动添加到此地图上。可选
panelString|HTMLElement结果列表的HTML容器id或容器元素,提供此参数后,结果列表将在此容器中进行展示。可选
hideMarkersBoolean设置隐藏路径规划的起始点图标,设置为true:隐藏图标;设置false:显示图标                                默认值为:false
showTrafficBoolean设置是否显示实时路况信息,默认设置为true。显示绿色代表畅通,黄色代表轻微拥堵,红色代表比较拥堵,灰色表示无路况信息。
isOutlineBoolean使用map属性时,绘制的规划线路是否显示描边。缺省为true
outlineColorString使用map属性时,绘制的规划线路的描边颜色。缺省为’white’
autoFitViewBoolean用于控制在路径规划结束后,是否自动调整地图视野使绘制的路线处于视口的可见范围
provinceString车辆牌照省份,如‘京’
numberNumber车牌号,如‘111111’
方法返回值说明
search(path:Array,cbk:function(status:String,result:DrivingResult))
根据路径,实现货车路线规划,path支持两种格式第一种,使用经纬度:var path = [];path.push({lnglat:[116.303843, 39.983412]//位置必填pid:'XXXX',//POI ID,可缺省type:'YYY'//POI类型,可缺省});//起点path.push({lnglat:[116.321354, 39.896436]});//途径path.push({lnglat:[116.407012, 39.992093]});//终点truckdriving.search(path,function(status, result) { });
第二种,使用关键字自动匹配:var path = [{keyword:'北京站',city:'010'},//起点{keyword:'北京西站',city:'010'},//途径{keyword:'北京大学',city:'010'}//终点];truckdriving.search(path,function(status, result) { });
clear()
清除搜索结果
setProvinceAndNumber(province:String,number:Number)
修改车牌号

DrivingResult 对象

属性类型说明
infoString成功状态说明
originLngLat驾车规划起点坐标
destinationLngLat驾车规划终点坐标
startPoi驾车规划起点
endPoi驾车规划终点
waypointsPoi驾车规划途经点
taxi_costNumber打车费用,仅extensions为“all”时返回单位:元
routesArray.<DriveRoute>驾车规划路线列表

DriveRoute 对象

属性类型说明
distanceNumber起点到终点的驾车距离,单位:米
timeNumber时间预计,单位:秒
policyString驾车规划策略
tollsNumber此驾车路线收费金额,单位:元
tolls_distanceNumber收费路段长度,单位:米
stepsArray.<DriveStep>子路段DriveStep集合
 restriction Number限行结果0 代表限行已规避或未限行,即该路线没有限行路段1 代表限行无法规避,即该线路有限行路段

DriveStep 对象(基本信息)

属性类型说明
start_locationLngLat此路段起点
end_locationLngLat此路段终点
instructionString此路段说明,如“沿北京南站路行驶565米右转”
actionString本驾车子路段完成后动作
assist_actionString驾车子路段完成后辅助动作,一般为到达某个目的地时返回
orientationString驾车方向
roadString道路
distanceNumber此路段距离,单位:米
tollsNumber此段收费,单位:元
tolls_distanceNumber收费路段长度,单位:米
toll_roadString主要收费道路
timeNumber此路段预计使用时间,单位:秒
pathArray.<LngLat>此路段坐标集合

DriveStep 对象(详细信息)

属性类型说明
citiesArray.<ViaCity>途径城市列表
tmcsArray.<TMC>实时交通信息列表

ViaCity 对象

属性类型说明
nameString途径名称
citycodeString城市编码
adcodeString区域编码
districtsArray.<District>途径行政区列表

District 对象

属性类型说明
nameString区域名称
adcodeString区域编码

TMC 对象

属性类型说明
lcodeString路况信息对应的编码如果direction是正向 lcode返回值大于0;否则lcode,返回值小于0;如果返回0则说明此路段无lcode
distanceNumber此lcode对应的路段长度,单位: 米
statusString路况状态,可能的值有:未知,畅通,缓行,拥堵

AMap.Transfer

公交换乘服务,提供起始点公交路线规划服务,目前公交换乘仅支持同一城市的公交路线规划,跨城市出行规划请参考驾车导航查询。公交换乘查询返回结果整合步行信息,若换乘路段(Segment)换乘类型为地铁 “SUBWAY”,则至少包含一条地铁口信息(SubwayEntrance)。用户可以通过自定义回调函数取回并显示查询结果。若服务请求失败,系统将返回错误信息

构造函数说明
AMap.Transfer(opts:TransferOptions )构造函数,提供公交换成查询功能
TransferOptions类型说明
cityString公交换乘的城市,支持城市名称、城市区号、电话区号,此项为必填
policyTransferPolicy公交换乘策略
nightflagBoolean是否计算夜班车,默认为不计算true:计算,false:不计算
citydString终点城市,跨城公交路径规划时为必填参数
extensionsString返回结果控制可选值:base/allbase:返回基本信息all:返回全部信息默认值 :base
mapMapAMap.Map对象, 展现结果的地图实例。当指定此参数后,搜索结果的标注、线路等均会自动添加到此地图上。可选参数
panelString|HTMLElement结果列表的HTML容器id或容器元素,提供此参数后,结果列表将在此容器中进行展示。可选参数
hideMarkersBoolean设置隐藏路径规划的起始点图标,设置为true:隐藏图标;设置false:显示图标 默认值为:false
isOutlineBoolean使用map属性时,绘制的规划线路是否显示描边。缺省为true
outlineColorString使用map属性时,绘制的规划线路的描边颜色。缺省为’white’
autoFitViewBoolean用于控制在路径规划结束后,是否自动调整地图视野使绘制的路线处于视口的可见范围
方法返回值说明
search(origin:LngLat,destination:LngLat,callback:function(status:String,result:info/TransferResult))                  search(point:Array.<Object>,callback:function(status:String,result:info/TransferResult))                 
根据起点和终点坐标/名称,进行公交换乘查询;当根据起、终点名称查询时,point为包含起点、终点的数组,例:[{keyword:‘北京南站’},{keyword:‘北京西站’}]当数组超过两个元素时,取前两个元素为起点、终点,其余元素忽略;当status为complete时,result为TransferResult;当status为error时,result为错误信息info;当status为no_data时,代表检索返回0结果。 相关示例
setPolicy(policy:TransferPolicy)
设置公交换乘策略
setCity(city:String)
设置公交换乘查询的城市
setCityd(city:String)
设置公交换乘查询的城市
leaveAt(time:String,data:String)
设置公交路径规划出发时间
clear()
清除结果显示
searchOnAMAP(obj:Object)
唤起高德地图客户端公交路径规划Obj参数形如:{   origin:LngLat,//起点坐标originName: “清华大学”,//起点名称destination:LngLat,//终点坐标destinationName: “首开广场”  //终点名称 }
事件参数说明
completeTransferResult当查询成功时触发此事件
errorErrorStatus当查询失败时触发此事件

TransferPolicy 对象

属性类型说明
LEAST_TIMEConst最快捷模式
LEAST_FEEConst最经济模式
LEAST_TRANSFERConst最少换乘模式
LEAST_WALKConst最少步行模式
MOST_COMFORTConst最舒适模式
NO_SUBWAYConst不乘地铁模式

TransferResult 对象

属性类型说明
infoString成功状态说明
originLngLat公交换乘起点坐标
destinationLngLat公交换乘终点坐标
startPoi公交换乘起点
endPoi公交换乘终点
taxi_costNumber出租车费用,单位:元
plansArray.<TransferPlan>换乘方案列表

TransferPlan 对象

属性类型说明
costNumber此换乘方案价格,单位:元
timeNumber预期时间,单位:秒
distanceNumber此换乘方案全程距离,单位:米
nightLineBoolean是否夜间线路
walking_distanceNumber此方案总步行距离,单位:米
transit_distanceNumber此方案公交行驶距离,单位:米
railway_distanceNumber此方案火车行驶距离,单位:米
taxi_distanceNumber此方案出租车行驶距离,单位:米
pathArray.<LngLat>此换乘方案的路径坐标集合
segmentsArray.<Segment>换乘路段列表,以每次换乘动结束作为分段点,将整个换乘方案分隔成若干 Segment(换乘路段)

Segment 对象

属性类型说明
instructionString此换乘段的文字描述规则:当 transit_mode 为“WALK”时,步行 distance 到 on_station/全程终点;当 transit_mode 为“SUBWAY/BUS/METRO_RAIL”时,乘坐 line ,途径 via_num 站到 off_station/全程终点
transit_modeString换乘动作类型,包括 BUS、SUBWAY、WALK、METRO_RAIL、RAILWAY、TAXI
timeNumber此换乘段预期用时,单位:秒
transitTransitDetails|WalkDetails此换乘段导航信息,当 transit_mode 为 “WALK” 时返回 WalkDetails,为 “BUS” 或 “SUBWAY/METRO_RAIL” 时返回 TransitDetails,当transit_mode为“RAILWAY”时,返回RailwayDetails,当transit_mode为“TAXI”时,返回TaxiDetails
distanceNumber此换乘段距离

WalkDetails 对象

属性类型说明
originLngLat此换乘段的步行起点
destinationLngLat此换乘段的步行终点
stepsArray.<WalkStep>步行子路段WalkStep列表
pathArray.<LngLat>此换乘段坐标集合

WalkStep 对象

属性类型说明
instructionString步行子路段描述规则:沿 road步行 distance 米 action,例:”沿北京站街步行351米”
distanceNumber步行子路段距离,单位:米
timeNumber步行子路段预计使用时间,单位:秒
pathArray.<LngLat>步行子路段坐标集合
roadString道路
actionString本步行子路段完成后动作
assist_actionString步行子路段完成后辅助动作,一般为到达某个公交站点或目的地时返回

TransitDetails 对象

属性类型说明
on_stationStop此换乘段的上车站
off_stationStop此换乘段的下车站
linesArray.<TransitLine>此换乘段公交路线
via_numNumber途径公交站点数(不包括上车站和下车站)
via_stopsArray.<Stop>途径公交站点集合(不包括上车站和下车站)
pathArray.<LngLat>此换乘段公交部分(上车站-下车站)坐标集合
entranceSubwayEntrance地铁站入口
exitSubwayEntrance地铁站出口

RailwayDetails 对象

属性类型说明
nameString线路名称
idString线路id编码
typeString线路车次类型,参考火车路线类型列表
tripNumber线路车次号
timeNumber该线路车段耗时
departure_stopRail_Stop火车始发站信息
altersArray.<Alter>聚合的备选方案,extensions=all时返回
arrival_stopRail_Stop火车到站信息
via_stopsArray.<Via_Stop>途经站点信息,extensions=all时返回
spacesArray.<Space>仓位及价格信息
distanceNumber该换乘段的行车总距离

TaxiDetails 对象

属性类型说明
originLngLat打车起点坐标
destinationLngLat打车终点坐标
distanceNumber该方案的总距离,单位:米
timeNumber耗时,单位:秒
snameString起点名称
tnameString终点名称

TransitLine 对象

属性类型说明
nameString公交路线名
idString公交路线ID
typeString公交类型,参考公交类型列表
stimeString公交路线首班车时间
etimeString公交路线末班车时间

SubwayEntrance 对象

属性类型说明
nameString地铁口名称
locationLngLat地铁口经纬度坐标

Stop 对象

属性类型说明
nameString公交站点名称
idString公交站点ID
locationLngLat站点经纬度信息

Via_Stop 对象

属性类型说明
nameString途径车站点名称
idString途径车站点ID
locationLngLat站点经纬度信息
waitNumber途径站点的停靠时间,单位:分钟
timeNumber途径站点的进站时间,如大于24:00,则表示跨天

Rail _Stop 对象

属性类型说明
nameString上、下车站点名称
idString上、下车站点ID
locationLngLat上、下站点经纬度信息
adcodeNumber上、下车站点所在城市的adcode
timeNumber上下车点发车时间

Space 对象

属性类型说明
typeNumber仓位编码,参考仓位级别表
costNumber仓位费用

Alter 对象

属性类型说明
idNumber备选方案ID
nameString备选线路名称

公交类型列表

公交类型说明
普通公交线路
地铁线路
轻轨线路
有轨电车
无轨电车
旅游专线
机场大巴
社区专车
磁悬浮列车线路
轮渡
索道交通
其他公交线路

火车路线类型表

公共交通工具备注说明
普客火车
G字头的高铁火车
D字头的动车火车
C字头的城际火车
Z字头的直达特快火车
T字头的特快火车
K字头的快车火车
L字头,Y字头的临时火车
S字头的郊区线火车

仓位级别表

仓位备注说明
不分仓位级别
特等座
火车硬座
火车软座
火车软座1等座
火车软座2等座
火车硬卧上铺
火车硬卧中铺
火车硬卧下铺

AMap.Walking

AMap.Walking步行导航服务,提供起始、终点步行路线查询服务。用户可以通过自定义回调函数取回并显示查询结果。若服务请求失败,系统将返回错误信息

相关示例

构造函数说明
AMap.Walking (opts:WalkingOptions )构造函数,提供步行路径规划功能
WalkingOptions类型说明
mapMapAMap.Map对象, 展现结果的地图实例。当指定此参数后,搜索结果的标注、线路等均会自动添加到此地图上。可选参数
panelString|HTMLElement结果列表的HTML容器id或容器元素,提供此参数后,结果列表将在此容器中进行展示。可选参数
hideMarkersBoolean设置隐藏路径规划的起始点图标,设置为true:隐藏图标;设置false:显示图标 默认值为:false
isOutlineBoolean使用map属性时,绘制的规划线路是否显示描边。缺省为true
outlineColorString使用map属性时,绘制的规划线路的描边颜色。缺省为’white’
autoFitViewBoolean用于控制在路径规划结束后,是否自动调整地图视野使绘制的路线处于视口的可见范围
方法返回值说明
search(origin:LngLat,destination:LngLat,callback:function(status:String,result:info/WalkingResult))                                  search(point:Array.<Object>,callback:function(status:String,result:info/WalkingResult))                 
根据起点和终点坐标,实现步行导航规划;当按起点、终点名称时,point为包含起点、终点的数组,例:[{keyword:‘方恒国际中心A座’},{keyword:‘望京站’}]当数组超过两个元素时,取前两个元素为起点、终点,其余元素忽略;当status为complete时,result为WalkingResult;当status为error时,result为错误信息info;当status为no_data时,代表检索返回0结果。
clear()
清除搜索的结果
事件参数说明
completeWalkingResult当查询成功时触发此事件
errorErrorStatus当查询失败时触发此事件
searchOnAMAP(obj:Object)
唤起高德地图客户端步行路径规划obj参数形如:{   origin:LngLat,起点坐标originName: “清华大学”,起点名称destination:LngLat,终点坐标destinationName: “首开广场”  终点名称 }

WalkingResult 对象

属性类型说明
infoString成功状态说明
originLngLat步行导航起点坐标
destinationLngLat步行导航终点坐标
startPoi步行导航起点
endPoi步行导航终点
countNumber步行导航路段数目
routesArray.<WalkRoute>步行规划路线列表

WalkRoute 对象

属性类型说明
distanceNumber起点到终点总步行距离,单位:米
timeNumber步行时间预计,单位:秒
stepsArray.<WalkStep>路段列表,以道路名称作为分段依据,将整个步行导航方案分隔成若干路段

WalkStep 对象

属性类型说明
start_locationLngLat本路段的起点坐标
end_locationLngLat本路段的终点坐标
instructionString此路段说明,如“沿北京南站路步行565米右转”
distanceNumber此路段距离,单位:米
timeNumber此路段预计使用时间,单位:秒
pathArray.<LngLat>此路段坐标集合
actionString本步行子路段完成后动作
assist_actionString本步行子路段完成后辅助动作,一般为到达某个目的地时返回
orientationString步行方向
roadString道路

AMap.Riding

AMap.Riding骑行路径规划服务,提供起始、终点骑行路线查询服务。用户可以通过自定义回调函数取回并显示查询结果。若服务请求失败,系统将返回错误信息

相关示例

构造函数说明
AMap.Riding (opts:RidingOptions )构造函数,提供步行路径规划功能
RidingOptions类型说明
mapMapAMap.Map对象, 展现结果的地图实例。当指定此参数后,搜索结果的标注、线路等均会自动添加到此地图上。可选参数
policyNumber骑行路线规划策略;可选值为:0:推荐路线及最快路线综合1:推荐路线2:最快路线默认值:0
panelString|HTMLElement结果列表的HTML容器id或容器元素,提供此参数后,结果列表将在此容器中进行展示。可选参数
hideMarkersBoolean设置隐藏路径规划的起始点图标,设置为true:隐藏图标;设置false:显示图标 默认值为:false
isOutlineBoolean使用map属性时,绘制的规划线路是否显示描边。缺省为true
outlineColorString使用map属性时,绘制的规划线路的描边颜色。缺省为’white’
autoFitViewBoolean用于控制在路径规划结束后,是否自动调整地图视野使绘制的路线处于视口的可见范围
方法返回值说明
search(origin:LngLat,destination:LngLat,callback:function(status:String,result:info/RidingResult))或 search(point:Array.<Object>,callback:function(status:String,result:info/RidingResult))                 
根据起点和终点坐标,实现骑行路径规划;当按起点、终点名称时,point为包含起点、终点的数组,例:[{keyword:‘方恒国际中心A座’},{keyword:‘望京站’}]当数组超过两个元素时,取前两个元素为起点、终点,其余元素忽略;当status为complete时,result为RidingResult;当status为error时,result为错误信息info;当status为no_data时,代表检索返回0结果。
clear()
清除搜索的结果
事件参数说明
completeRidingResult当查询成功时触发此事件
errorErrorStatus当查询失败时触发此事件

RidingResult 对象

属性类型说明
infoString成功状态说明
originLngLat骑行导航起点坐标
destinationLngLat骑行导航终点坐标
startPoi骑行导航起点
endPoi骑行导航终点
countNumber骑行导航路段数目
routesArray.<RideRoute>骑行规划路线列表

RideRoute 对象

属性类型说明
distanceNumber起点到终点总步行距离,单位:米
timeNumber步行时间预计,单位:秒
ridesArray.<RideStep>路段列表,以道路名称作为分段依据,将整个骑行导航方案分隔成若干路段

RideStep 对象

属性类型说明
start_locationLngLat本路段的起点坐标
end_locationLngLat本路段的终点坐标
instructionString此路段说明,如“沿北京南站路骑行565米右转”
distanceNumber此路段距离,单位:米
timeNumber此路段预计使用时间,单位:秒
pathArray.<LngLat>此路段坐标集合
actionString本骑行子路段完成后动作
assist_actionString本骑行子路段完成后辅助动作,一般为到达某个目的地时返回
orientationString步行方向
roadString道路

AMap.DragRoute

拖拽导航插件。通过鼠标拖拽已有导航路径上的任一点,可以实现导航起点、途经点、终点的调整,系统根据调整后的起点、途经点、终点信息,实时查询拖拽后的导航路径并在地图上同步显示。支持     驾车策略。建议途径点个数不超过16个,以保证良好的体验效果。

代码示例

JavaScript

mapObj = new AMap.Map("iCenter");
//绘制初始路径
var path = [];
path.push(new AMap.LngLat(116.303843,39.983412));
path.push(new AMap.LngLat(116.321354,39.896436));
path.push(new AMap.LngLat(116.407012,39.992093));
mapObj.plugin("AMap.DragRoute",function(){
    route = new AMap.DragRoute(mapObj, path, AMap.DrivingPolicy.LEAST_FEE); //构造拖拽导航类,传入参数分别为:地图对象,初始路径,驾车策略
    route.search(); //查询导航路径并开启拖拽导航
});

相关示例

构造函数说明
AMap.DragRoute(map:Map,path:Array.<LngLat>,policy:DrivingPolicy,opts:DragRouteOptions)DragRoute构造函数。参数Map为指定的地图对象,path指定导航的起点、途经点、终点的经纬度坐标数组,policy指定驾车策略。目前仅支持桌面浏览器
DragRouteOptions类型说明
polyOptionsObject设置拖拽路线插件的路线属性对象,包括线样式、宽度、颜色等,参考PolylineOptions列表。
startMarkerOptionsObject设置拖拽路线插件起点点标记属性对象,包括点标记样式、大小等,参考MarkerOptions列表。
midMarkerOptionsObject设置拖拽路线插件途经点点标记属性对象,包括点标记样式、大小等,参考MarkerOptions列表列表。
endMarkerOptionsObject设置拖拽路线插件终点点标记属性对象,包括点标记样式、大小等,参考MarkerOptions列表列表。
showTrafficBoolean设置显示实时路况信息,true:路线中显示实时路况信息,false:关闭实时路况信息默认值:true
方法返回值说明
search( )
开始路径导航。支持鼠标拖拽导航路径节点,更改途经点时,系统实时重新计算并显示导航路径
getWays( )Array.<LngLat>返回除了起点和终点之外的所有点
getRoute( )Array.<LngLat>返回当前导航路径,即导航路径的经纬度坐标数组,需要在complete回调中执行。
destroy( )
销毁拖拽导航插件。
事件参数说明
addway{type,lnglat,target}添加途经点触发的事件
complete{type,target,data}驾车路径规划完成时触发的事件,data同Driving驾车路线规划返回结果DrivingResult

驾车策略

DrivingPolicy类型说明
LEAST_TIMEConst最快捷模式
LEAST_FEEConst最经济模式
LEAST_DISTANCEConst最短距离模式
REAL_TRAFFICConst考虑实时路况

AMap.ArrivalRange

AMap.ArrivalRange根据输入的起点坐标和设定的时间范围,可以计算出用户在你设定的时间段内按公交出行方式,可以到达的距离范围。用户可以通过自定义回调函数取回并显示查询结果。若服务请求失败,系统将返回错误信息

相关示例

构造函数说明
AMap.ArrivalRange()构造函数,示例化一个到达圈函数类
ArrivalRangeOptions类型说明
policyString公交出行策略,可选为:只坐地铁:SUBWAY, 只坐公交:BUS,缺省时为公交+地铁,BUS,SUBWAY
resultTypeString结果返回样式:polygon:返回多边形边界值,coverage:判断设定的终点坐标是否在到达圈范围内
destinationLngLat|Array.<LngLat>选择一个想到达的目的地坐标,最多支持5个目的地坐标
方法返回值说明
search(origin:LngLat,time:Number,callback:function(status:String,result:info/ArrivalRangeResult),opts:ArrivalRangeOptions)
计算某个时间段内用户通过公交出行可到达的距离范围

ArrivalRangeResult 对象

属性类型说明
infoString查询状态说明
boundsArray输出方式选择polygon时,返回到达圈边界坐标点
inRangeBoolean输出方式选择coverage时,返回提供的终点坐标是否在到达圈内
0 0 投票数
文章评分
订阅评论
提醒
0 评论
内联反馈
查看所有评论
0
希望看到您的想法,请您发表评论x