路径规划 api.docVIP

路径规划 API 概述: Autonavi路径规划API可以规划自驾，公交及步行三种路径。一条路径（Route）由多个路段组成。如自驾路径的可能像这样，从出发点沿路A直行 （路段1），在路口左转进入路B( 路段2 )，再向左转进入路C（路段3）。公交路径也一样，如从出发点走到车站A（路段1），坐X站（路段2）, 走100米换乘地铁（路段3），坐Y站下车（路段4），走200米到达目的地（路段5）。可以看出，3种路径规划，均可抽象为路径加路段的概念。 除了基本的路径规划外，本API还提供了把路径作为Overlay加入到地图的功能。 Route.FromAndTo class： 2.1 概述： Route.FromAndTo是类Route的内部类。它定义了路径计算时的起始点。该类为构造路径时的帮助类。此类中定义的起点和终点，可能与路径计算结果的起点终点不一样。原因有二，一是可能要求了坐标偏转，二是对于自驾路径，导航引擎会将远离道路的起点终点移至较近的道路上。 2.2 构造函数 public FromAndTo(GeoPoint from, GeoPoint to, int trans) 构造函数。参数from定义了路径的起点，参数to定义了终点，参数trans决定了坐标偏转的设定。见2.3常量说明。 public FromAndTo(GeoPoint from, GeoPoint to) 构造函数。参数from定义了路径的起点，参数to定义了终点，且起点终点坐标不做偏转。见2.3常量说明。 2.3 常量定义： public static final int NoTrans; 不做偏转。 public static final int TransFromPoint = 1; 仅对起点做偏转 public static final int TransToPoint = 2; 仅对终点做偏转 public static final int TransBothPoint = 3; 对起点和终点做偏转 Route class 概述： Route类定义了一条路径。此类不可以直接构造，只能通过类的静态（static）函数得到其实例。一条路径，可以是公交路径，步行路径，或者自驾路径。根据构建时的参数，可以得到不同的路径。 成员变量： protected String mStartPlace： 路径起始点的描述 protected String mTargetPlace： 路径目的地的描述 protected ListSegment mSegs： 此路径所包含的路段列表，按照起点至终点的次序排列。 常量： static public final int BusDefault ; 路径为公交模式。 static public final int BusSaveMoney ; 路径为公交模式，但路径计算时尽量选择车票花销小的路线。 static public final int BusLeaseChange ; 路径为公交模式，但路径计算时尽量选择换乘次数少的路线。 static public final int BusLeaseWalk ; 路径为公交模式，但路径计算时尽量选择步行长度小的路线。 static public final int BusMostComfortable; 路径为公交模式，但路径计算时尽量选择最舒适的路线。 static public final int DrivingDefault; 路径为自驾模式 static public final int DrivingSaveMoney ; 路径为自驾模式，但路径计算时尽量选择最省钱的路线 – 比如尽可能少走收费道路。 static public final int DrivingLeastDistance ; 路径为自驾模式，但路径计算时尽量选择行驶距离最短的路线 static public final int DrivingNoFastRoad; 路径为自驾模式，但路径计算时不考虑走高速路 static public final int WalkDefault; 路径为步行模式 public static boolean isDrive(int mode)： 如果参数mode为DrivingDefault，DrivingSaveMoney，DrivingLeastDistance， DrivingNoFastRoad之一，则返回true,否则返回false。（参见3.3） public static boolean isBus(int mode)： 如果参数mode为BusDefault，BusSaveMoney，BusLeaseChange， BusLeaseW