TencentMapSDK_iOS_3D_v6.8.0

载入中...
搜索中...
未找到
实例方法 | 属性 | 所有成员列表
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
| read write nonatomic copy

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

样例: 4077524088693206111

## ◆ from_track

- (NSString*) from_track
| read write nonatomic copy

起点轨迹

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

## ◆ heading

- (NSNumber*) heading
| read write nonatomic copy

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

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

## ◆ perference

- (QMSDrivingRoutePerference) perference
| read write nonatomic assign

    @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
| read write nonatomic copy

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

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

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

- QMSSearchOption.h