路径规划 API

路径规划API1.概述:Autonavi路径规划API可以规划自驾，公交及步行三种路径。一条路径（Route）由多个路段组成。如自驾路径的可能像这样，从出发点沿路A直行（路段1），在路口左转进入路B(路段2)，再向左转进入路C（路段3）。公交路径也一样，如从出发点走到车站A（路段1），坐X站（路段2）,走100米换乘地铁（路段3），坐Y站下车（路段4），走200米到达目的地（路段5）。可以看出，3种路径规划，均可抽象为路径加路段的概念。除了基本的路径规划外，本API还提供了把路径作为Overlay加入到地图的功能。2.Route.FromAndToclass：2.1概述：Route.FromAndTo是类Route的内部类。它定义了路径计算时的起始点。该类为构造路径时的帮助类。此类中定义的起点和终点，可能与路径计算结果的起点终点不一样。原因有二，一是可能要求了坐标偏转，二是对于自驾路径，导航引擎会将远离道路的起点终点移至较近的道路上。2.2构造函数publicFromAndTo(GeoPointfrom,GeoPointto,inttrans)构造函数。参数from定义了路径的起点，参数to定义了终点，参数trans决定了坐标偏转的设定。见2.3常量说明。publicFromAndTo(GeoPointfrom,GeoPointto)构造函数。参数from定义了路径的起点，参数to定义了终点，且起点终点坐标不做偏转。见2.3常量说明。2.3常量定义：publicstaticfinalintNoTrans;不做偏转。publicstaticfinalintTransFromPoint=1;仅对起点做偏转publicstaticfinalintTransToPoint=2;仅对终点做偏转publicstaticfinalintTransBothPoint=3;对起点和终点做偏转3.Routeclass3.1概述：Route类定义了一条路径。此类不可以直接构造，只能通过类的静态（static）函数得到其实例。一条路径，可以是公交路径，步行路径，或者自驾路径。根据构建时的参数，可以得到不同的路径。3.2成员变量：protectedStringmStartPlace：路径起始点的描述protectedStringmTargetPlace：路径目的地的描述protectedListSegmentmSegs：此路径所包含的路段列表，按照起点至终点的次序排列。3.3常量：staticpublicfinalintBusDefault;路径为公交模式。staticpublicfinalintBusSaveMoney;路径为公交模式，但路径计算时尽量选择车票花销小的路线。staticpublicfinalintBusLeaseChange;路径为公交模式，但路径计算时尽量选择换乘次数少的路线。staticpublicfinalintBusLeaseWalk;路径为公交模式，但路径计算时尽量选择步行长度小的路线。staticpublicfinalintBusMostComfortable;路径为公交模式，但路径计算时尽量选择最舒适的路线。staticpublicfinalintDrivingDefault;路径为自驾模式staticpublicfinalintDrivingSaveMoney;路径为自驾模式，但路径计算时尽量选择最省钱的路线–比如尽可能少走收费道路。staticpublicfinalintDrivingLeastDistance;路径为自驾模式，但路径计算时尽量选择行驶距离最短的路线staticpublicfinalintDrivingNoFastRoad;路径为自驾模式，但路径计算时不考虑走高速路staticpublicfinalintWalkDefault;路径为步行模式3.4publicstaticbooleanisDrive(intmode)：如果参数mode为DrivingDefault，DrivingSaveMoney，DrivingLeastDistance，DrivingNoFastRoad之一，则返回true,否则返回false。（参见3.3）3.5publicstaticbooleanisBus(intmode)：如果参数mode为BusDefault，BusSaveMoney，BusLeaseChange，BusLeaseWalk，BusMostComfortable之一，则返回true,否则返回false。（参见3.3）3.6publicstaticbooleanisWalk(intmode)：如果参数mode等于WalkDefault，则返回true,否则返回false。（参见3.3）3.7staticpublicListRoutecalculateRoute(Contextcnt,Stringkey,FromAndTofromAndTo,intmode)throwsIOException：路径的起始点由参数fromAndTo决定（见下面类FromAndTo的说明），路径模式由参数mode决定（见2.3路径模式的常量定义）。参数cnt为对应的Context，参数key为APIkey。返回值为可能的路径列表。如果网络连接有问题则抛出IOException，如果参数设置有问题，则抛出IllegalArgumentException。3.8staticpublicListRoutecalculateRoute(MapActivityact,FromAndTofromAndTo,intmode)throwsIOException：同3.7，但参数cnt与key变成了类MapActivity的实例。3.9publicintgetMode()：返回该路径计算时选取的模式，返回值为3.3定义的常量之一。3.10publicStringgetStartPlace()：返回起点的地址描述。3.11publicStringgetTargetPlace()：返回终点的地址描述。3.12publicGeoPointgetStartPos()：返回起点坐标3.13publicGeoPointgetTargetPos()：返回终点坐标3.14publicintgetStepCount()：返回路径中的路段数目。3.15publicSegmentgetStep(inti)：返回第i个路段，路段的索引从0开始计数。3.16publicintgetSegmentIndex(Segmentseg)：参数seg定义了待查找的路段，返回值为该路段在本路径中的索引。如果未找到此路段，则返回-1。3.17publicStringgetStepedDescription(inti)：返回对第i个路段的描述。3.18publicStringgetOverview()：返回对路径的概况描述。3.19publicGeoPointgetLowerLeftPoint()：一个路径是由一组线段组成，getLowerLeftPoint返回这些线段的外包矩形的左下角经纬度坐标。3.20publicGeoPointgetUpperRightPoint()：一个路径是由一组线段组成，getUpperRightPoint返回这些线段的外包矩形的右上角经纬度坐标。4.Segmentclass:4.1概述：此类定义了一个路段。路段属于路径的一部分，因此有次序的概念。4.2成员变量：protectedGeoPoint[]mShapes;路段的形状点数组。protectedRoutemRoute;此路段所属的路径。protectedintmLength;此路段的长度4.3publicSegmentgetPrev()：返回此路段的前一个路段。如果此路段为首个路段，则返回null。4.4publicSegmentgetNext()：返回此路段的下一个路段。如果此路段为最后的路段，则返回null。4.5publicGeoPointgetFirstPoint()：返回此路段的首个形状点坐标。4.6publicGeoPointgetLastPoint()：返回此路段的最后一个形状点坐标。4.7publicGeoPointgetLowerLeftPoint()：一个路段是由一组线段组成，getLowerLeftPoint返回这些线段的外包矩形的左下角经纬度坐标。4.8publicGeoPointgetUpperRightPoint()：一个路段是由一组线段组成，getUpperRightPoint返回这些线段的外包矩形的右上角经纬度坐标。5.BusSegmentclass:5.1概述：此类为Segment的子类，它定义了一个公交路段。注意，公交路径中所包含的路段中既有BusSegment，BusSegment定义一段公交，也有Segment，它定义了一段步行，比如从某点走到车站。5.2成员变量：protectedStringmLine;公交的名称。protectedStringmFirstStation;该公交线路的始点站名。protectedStringmLastStation;该公交线路的终点站名。protectedGeoPoint[]mPassStopPos;该公交线路的从上车站到下车站的途经站点坐标。protectedString[]mPassStopName;该公交线路的从上车站到下车站的途经站点名称。5.3protectedintgetStopNumber()：返回从上车站，到下车站的车站数目。这个数目包含上车站与下车站。5.4publicStringgetLineName()：返回公交线路名称。5.5publicStringgetFirstStationName()：返回线路起始点名称5.6publicStringgetLastStationName()：返回线路终点名称Asd5.7publicStringgetOnStationName()：返回上车站名称。5.8publicStringgetOffStationName()：返回下车站名称。6.classDriveWalkSegment：6.1概述：该类定义了自驾路径，步行路径中的路段。自驾，步行中所有的行驶/行走方向的决策，要人自己决定。因此，有一个Action（行动）的概念。在每一个路段的起点，定义了该点对应的Action，比如左拐，调头等。6.2成员变量：protectedintmActionCode;此路段的行动代码(Actioncode)。protectedStringmActionDes;此路段行动描述，如左转，右转等等。protectedStringmRoadName;该路段的道路名称。6.3publicStringgetActionDescription()：返回此路段的行动描述。6.4publicintgetActionCode()：返回此路段的行动代码。6.5publicStringgetRoadName()：返回此路段对应的道路名称。7.interfaceRouteMessageHandle：7.1概述：此接口用于接收RouteOverlay（见8）的事件。7.2publicbooleanonRouteEvent(MapViewmapView,RouteOverlayoverlay,intindex,intaction)：在合适的事件发生时，此函数会被RouteOverlay回调。参数mapView定义了地图控件。参数overlay为发生事件的RouteOverlay,参数index为发生事件的路段在对应路径中的索引，由于终点被定义成可点击，所以，index的范围为：0（对应起点）至路段数（对应终点），即被。参数action定义了对应的事件代码（参见8.2）。当返回值为true的时候，说明该事件已被处理过，不需要RouteOverlay层再进一步处理。如果返回false，则Ro