QMSDrivingRouteSearchOption类 参考

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

#include <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

to_poi

- (NSString*) to_poi

readwritenonatomiccopy

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

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

---

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

• QMSSearchOption.h