驾车路线规划的检索参数更多...

#import <QMSSearchOption.h>

类 QMSDrivingRouteSearchOption 继承关系图:

构造函数
(void)	- setFromCoordinate:
	以CLLocationCoordinate2D方式设置起点经纬度更多...

(void)	- setTrackPoints:
	设置起点轨迹更多...

(void)	- setToCoordinate:
	以CLLocationCoordinate2D方式设置终点点经纬度更多...

(void)	- setPolicyWithType:
	枚举方式设置查询策略更多...

(void)	- setWayPointsWithCoordinates:count:
	以CLLocationCoordinate2D数据方式设置途径点, 最大途经点个数为30个. 更多...

(void)	- setAvoidPolygon:
	设置避让区域更多...

属性
NSString *	from
	起点坐标格式： from=lat<纬度>,lng<经度>

NSString *	from_poi
	起点POI ID，传入后，优先级高于from（坐标）更多...

NSString *	from_track
	起点轨迹更多...

NSString *	to
	终点坐标格式： to=lat<纬度>,lng<经度>

NSString *	to_poi
	终点POI ID（可通过腾讯位置服务地点搜索服务得到），当目的地为较大园区、小区时，会以引导点做为终点（如出入口等），体验更优。更多...

NSString *	policy

QMSDrivingRoutePolicyTypeNew	policyType
	设置查询策略，单独设置policy 中策略参数目前支持的策略类型. QMSDrivingRoutePolicyTypeNewLeastTime: 参考实时路况，时间最短 QMSDrivingRoutePolicyTypeNewPickup: 网约车场景 - 接乘客 QMSDrivingRoutePolicyTypeNewTrip: 网约车场景 – 送乘客更多...

QMSDrivingRoutePerference	perference

QMSRouteTagType	tag_mode
	路线标签形式：默认QMSRouteTagTypeAll 更多...

NSString *	waypoints
	途径点,元素类型为CLLocationCoordinate2D的NSValue类型

NSString *	avoid_polygons
	避让区域,元素类型为CLLocationCoordinate2D的NSValue类型避让区域：支持32个避让区域，每个区域最多可有9个顶格式：纬度在前，经度在后，用半角逗号 “,” 分隔，小数点后不超过6位，各经纬度之间用半角分号 “;” 分隔。各区域多边形间，用竖线符号分隔 “\|”

NSNumber *	heading
	[from辅助参数]在起点位置时的车头方向，数值型，取值范围0至360（0度代表正北，顺时针一周360度）更多...

NSNumber *	speed
	[from辅助参数]速度，单位：米/秒，默认3。当速度低于1.39米/秒时，heading将被忽略

NSNumber *	accuracy
	[from辅助参数]定位精度，单位：米，取>0数值，默认5。当定位精度>30米时heading参数将被忽略

NSString *	plate_number
	车牌号，填入后，路线引擎会根据车牌对限行区域进行避让，不填则不不考虑限行问题

int	get_mp
	是否返回多方案，取值：0 [默认]仅返回一条路线方案; 1 返回多方案（最多可返回三条方案供用户备选）

int	no_step
	是否返回路线引导信息，可使回包数据量更小，取值：0[默认]返回路线引导信息; 1不返回

int	cartype
	车辆类型（影响限行规则），取值：0：[默认]普通汽车; 1：新能源

int	get_speed
	返回路况信息, 取值：0: [默认]不返回；1: 返回

NSDate *	departure_time
	出发时间。若传入时间小于当前时间或者为空，服务端则使用当前时间.

属性继承自 QMSSearchOption
NSString *	added_fields
	设置额外字段, 每个字段使用,分隔, 例如 added_fields=cities,tolldistance

NSDictionary< NSString , NSString > *	extraParam
	设置请求补充参数, 例如："get_subpois" : @"1"} 更多...

详细描述

驾车路线规划的检索参数

函数文档

◆ setAvoidPolygon:

- (void) setAvoidPolygon: (NSArray< QMSUniveralPolygon * > *) avoidPolygons

设置避让区域

参数

avoidPolygons 避让区域数组, 经纬度数值小数点后不超过6位

◆ setFromCoordinate:

- (void) setFromCoordinate: (CLLocationCoordinate2D) coordinate

以CLLocationCoordinate2D方式设置起点经纬度

参数

coordinate 起点经纬度

◆ setPolicyWithType:

- (void) setPolicyWithType: ((deprecated("use @property(nonatomic, assign)QMSDrivingRoutePolicyTypeNew policyType; and @property(nonatomic, assign)QMSDrivingRoutePerference perference; instead"))) __attribute__

枚举方式设置查询策略

参数

type 查询策略

◆ setToCoordinate:

- (void) setToCoordinate: (CLLocationCoordinate2D) coordinate

以CLLocationCoordinate2D方式设置终点点经纬度

参数

coordinate 终点经纬度

◆ setTrackPoints:

- (void) setTrackPoints: (NSArray< QMSTrackPoint * > *) points

设置起点轨迹

此方法会生成from_track的值

在真实的场景中，易受各种环境及设备精度影响，导致定位点产生误差，传入起点前段轨迹，可有效提升准确度。优先级：高于from参数轨迹中的每个定位点包含以下信息： 1.纬度 2.经度 3.速度：GPS速度，单位米/秒，取不到传-1 4.精度：GPS精度, 单位毫米，取不到传-1 5.运动方向： gps方向，正北为0, 顺时针夹角，[0-360)，获取不到时传-1 6.设备方向：正北为0, 顺时针夹角，[0-360)，取不到传-1 7.时间：定位获取该点的时间，Unix时间戳，取不到传0 参数格式： 1.轨迹中最多支持传入50个点。 2.每个点之间英文分号分隔，时间顺序由旧到新（第一个点最早获取，最后一个点最新得到） 3.每个点中的信息用英文逗号分隔，并按以下顺序传入：纬度,经度,速度,精度,运动方向,设备方向,时间;第2个点;第3个点…… from=lat<纬度>,lng<经度>

◆ setWayPointsWithCoordinates:count:

- (void) setWayPointsWithCoordinates:	(CLLocationCoordinate2D *)	coordinates
count:	(NSUInteger)	count

以CLLocationCoordinate2D数据方式设置途径点, 最大途经点个数为30个.

参数

coordinates	途经点数组
count	数组长度

属性说明

◆ from_poi

- (NSString*) from_poi

readwritenonatomiccopy

起点POI ID，传入后，优先级高于from（坐标）

样例: 4077524088693206111

◆ from_track

- (NSString*) from_track

readwritenonatomiccopy

起点轨迹

可通过setTrackPoints生成. 格式样例： 40.037029,116.316633,16,500,160,-1,1529491290;40.036634,116.317170,16,500,161,-1,1529491300;...

◆ heading

- (NSNumber*) heading

readwritenonatomiccopy

[from辅助参数]在起点位置时的车头方向，数值型，取值范围0至360（0度代表正北，顺时针一周360度）

传入车头方向，对于车辆所在道路的判断非常重要，直接影响路线计算的效果

◆ perference

- (QMSDrivingRoutePerference) perference

readwritenonatomicassign

@brief  设置查询偏好，单独设置policy 中 偏好参数

无偏好（默认） QMSDrivingRoutePerferenceNone = 0, 参考实时路况 QMSDrivingRoutePerferenceRealTraffic = 1 << 0, 少收费 QMSDrivingRoutePerferenceLeastFee = 1 << 1, 高速优先 QMSDrivingRoutePerferenceHighwayFirst = 1 << 2, 不走高速 QMSDrivingRoutePerferenceAvoidHighway = 1 << 3, 大路优先 QMSDrivingRoutePerferenceHighroadFirst = 1 << 4, 该策略会通过终点坐标查找所在地点（如小区/大厦等），并使用地点出入口做为目的地，使路径更为合理 QMSDrivingRoutePerferenceNavPointFirst = 1 << 5

◆ policyType

- (QMSDrivingRoutePolicyTypeNew) policyType

readwritenonatomicassign

设置查询策略，单独设置policy 中策略参数目前支持的策略类型. QMSDrivingRoutePolicyTypeNewLeastTime: 参考实时路况，时间最短 QMSDrivingRoutePolicyTypeNewPickup: 网约车场景 - 接乘客 QMSDrivingRoutePolicyTypeNewTrip: 网约车场景 – 送乘客

◆ tag_mode

- (QMSRouteTagType) tag_mode

readwritenonatomicassign

路线标签形式：默认QMSRouteTagTypeAll

◆ to_poi

- (NSString*) to_poi

readwritenonatomiccopy

终点POI ID（可通过腾讯位置服务地点搜索服务得到），当目的地为较大园区、小区时，会以引导点做为终点（如出入口等），体验更优。

该参数优先级高于to（坐标），但是当目的地无引导点数据或POI ID失效时，仍会使用to（坐标）作为终点样例: 4077524088693206111

该类的文档由以下文件生成:

QMSSearchOption.h

构造函数

属性

详细描述

函数文档

◆ setAvoidPolygon:

◆ setFromCoordinate:

◆ setPolicyWithType:

◆ setToCoordinate:

◆ setTrackPoints:

◆ setWayPointsWithCoordinates:count:

属性说明

◆ from_poi

◆ from_track

◆ heading

◆ perference

◆ policyType

◆ tag_mode

◆ to_poi