高德地图SDK(Track)  V1.4.2
AMapTrackManager.h
Go to the documentation of this file.
1 //
2 // AMapTrackManager.h
3 // AMapTrackKit
4 //
5 // Created by liubo on 2017/8/15.
6 // Copyright © 2017年 Amap. All rights reserved.
7 //
8 
9 #import <UIKit/UIKit.h>
10 #import <CoreLocation/CoreLocation.h>
11 #import "AMapTrackError.h"
13 
14 #import "AMapTrackCommonObj.h"
15 #import "AMapTrackTerminalObj.h"
16 #import "AMapTrackTrackObj.h"
17 #import "AMapTrackHistoryObj.h"
18 
19 NS_ASSUME_NONNULL_BEGIN
20 
21 @protocol AMapTrackManagerDelegate;
22 
23 #pragma mark - AMapTrackManager
24 
25 @interface AMapTrackManager : NSObject
26 
28 - (instancetype)initWithOptions:(AMapTrackManagerOptions *)options NS_DESIGNATED_INITIALIZER;
29 
31 @property (nonatomic, weak) id<AMapTrackManagerDelegate> delegate;
32 
33 #pragma mark - Location
34 
36 @property (nonatomic, assign) CLActivityType activityType;
37 
39 @property (nonatomic, assign) CLLocationDistance distanceFilter;
40 
43 @property (nonatomic, assign) CLLocationAccuracy desiredAccuracy;
44 
46 @property (nonatomic, assign) BOOL pausesLocationUpdatesAutomatically;
47 
49 @property (nonatomic, assign) BOOL allowsBackgroundLocationUpdates;
50 
51 #pragma mark - Gather And Pack
52 
54 @property (nonatomic, readonly) NSUInteger gatherInterval;
55 
57 @property (nonatomic, readonly) NSUInteger packInterval;
58 
64 - (void)changeGatherAndPackTimeInterval:(NSInteger)gatherTimeInterval packTimeInterval:(NSInteger)packTimeInterval;
65 
66 #pragma mark - Service And Gather
67 
69 @property (nonatomic, readonly) NSString *serviceID;
70 
72 @property (nonatomic, readonly) NSString *terminalID;
73 
75 @property (nonatomic, copy) NSString *trackID;
76 
81 - (void)startServiceWithOptions:(AMapTrackManagerServiceOption *)options;
82 
86 - (void)stopService;
87 
91 - (void)startGatherAndPack;
92 
96 - (void)stopGaterAndPack;
97 
98 #pragma mark - Cache Size
99 
105 - (BOOL)setLocalCacheMaxSize:(NSInteger)cacheMaxSize;
106 
108 @property (nonatomic, readonly) NSUInteger cacheMaxSize;
109 
110 #pragma mark - Network
111 
113 @property (nonatomic, assign) NSInteger timeout;
114 
118 - (void)cancelAllRequests;
119 
120 #pragma mark - Terminal Request
121 
126 - (void)AMapTrackAddTerminal:(AMapTrackAddTerminalRequest *)request;
127 
132 - (void)AMapTrackQueryTerminal:(AMapTrackQueryTerminalRequest *)request;
133 
134 #pragma mark - Track Request
135 
140 - (void)AMapTrackAddTrack:(AMapTrackAddTrackRequest *)request;
141 
146 - (void)AMapTrackDeleteTrack:(AMapTrackDeleteTrackRequest *)request;
147 
148 #pragma mark - Track History Request
149 
154 - (void)AMapTrackQueryLastPoint:(AMapTrackQueryLastPointRequest *)request;
155 
160 - (void)AMapTrackQueryTrackDistance:(AMapTrackQueryTrackDistanceRequest *)request;
161 
166 - (void)AMapTrackQueryTrackHistoryAndDistance:(AMapTrackQueryTrackHistoryAndDistanceRequest *)request;
167 
172 - (void)AMapTrackQueryTrackInfo:(AMapTrackQueryTrackInfoRequest *)request;
173 
174 @end
175 
176 #pragma mark - AMapTrackManagerDelegate
177 
178 @protocol AMapTrackManagerDelegate <NSObject>
179 
180 @required
181 
182 #if __IPHONE_OS_VERSION_MAX_ALLOWED >= 140000
183 
197 - (void)amapTrackManager:(AMapTrackManager *)manager doRequireTemporaryFullAccuracyAuth:(CLLocationManager*)locationManager completion:(void(^)(NSError *error))completion;
198 
199 #endif
200 
201 @optional
202 
210 - (void)amapTrackManager:(AMapTrackManager *)manager doRequireLocationAuth:(CLLocationManager*)locationManager;
211 
212 
218 - (void)didFailWithError:(NSError *)error associatedRequest:(id)request;
219 
224 - (void)onStartService:(AMapTrackErrorCode)errorCode;
225 
230 - (void)onStopService:(AMapTrackErrorCode)errorCode;
231 
236 - (void)onStartGatherAndPack:(AMapTrackErrorCode)errorCode;
237 
242 - (void)onStopGatherAndPack:(AMapTrackErrorCode)errorCode;
243 
249 - (void)onStopGatherAndPack:(AMapTrackErrorCode)errorCode errorMessage:(nullable NSString *)errorMessage;
250 
255 - (NSDictionary <NSString *,NSString *> *)trackManagerGetCustomDictionary;
256 
257 #pragma mark - Terminal Request Done
258 
264 - (void)onAddTerminalDone:(AMapTrackAddTerminalRequest *)request response:(AMapTrackAddTerminalResponse *)response;
265 
271 - (void)onQueryTerminalDone:(AMapTrackQueryTerminalRequest *)request response:(AMapTrackQueryTerminalResponse *)response;
272 
273 #pragma mark - Track Request Done
274 
280 - (void)onAddTrackDone:(AMapTrackAddTrackRequest *)request response:(AMapTrackAddTrackResponse *)response;
281 
287 - (void)onDeleteTrackDone:(AMapTrackDeleteTrackRequest *)request response:(AMapTrackBaseResponse *)response;
288 
289 #pragma mark - Track History Request Done
290 
296 - (void)onQueryLastPointDone:(AMapTrackQueryLastPointRequest *)request response:(AMapTrackQueryLastPointResponse *)response;
297 
303 - (void)onQueryTrackDistanceDone:(AMapTrackQueryTrackDistanceRequest *)request response:(AMapTrackQueryTrackDistanceResponse *)response;
304 
310 - (void)onQueryTrackHistoryAndDistanceDone:(AMapTrackQueryTrackHistoryAndDistanceRequest *)request response:(AMapTrackQueryTrackHistoryAndDistanceResponse *)response;
311 
317 - (void)onQueryTrackInfoDone:(AMapTrackQueryTrackInfoRequest *)request response:(AMapTrackQueryTrackInfoResponse *)response;
318 
319 @end
320 
321 NS_ASSUME_NONNULL_END
AMapTrackManager::activityType
CLActivityType activityType
设定定位的活跃类型。默认为 CLActivityTypeAutomotiveNavigation 。
Definition: AMapTrackManager.h:36
AMapTrackManager::cacheMaxSize
NSUInteger cacheMaxSize
本地缓存最大值
Definition: AMapTrackManager.h:108
AMapTrackHistoryObj.h
AMapTrackTerminalObj.h
AMapTrackManagerDelegate-p
Definition: AMapTrackManager.h:178
-[AMapTrackManager cancelAllRequests]
void cancelAllRequests()
取消所有未回调的请求,触发错误回调didFailWithError:associatedRequest:。
AMapTrackDeleteTrackRequest
删除Track请求
Definition: AMapTrackTrackObj.h:36
AMapTrackManager::serviceID
NSString * serviceID
当前的serviceID,初始化时指定。
Definition: AMapTrackManager.h:69
AMapTrackManager::trackID
NSString * trackID
当前的trackID。
Definition: AMapTrackManager.h:75
AMapTrackManager::allowsBackgroundLocationUpdates
BOOL allowsBackgroundLocationUpdates
是否允许后台定位。默认为NO。只在iOS 9.0及之后起作用。设置为YES的时候必须保证 Background Modes 中的 Location updates 处于选中状态,否则会抛出异常。由于iO...
Definition: AMapTrackManager.h:49
AMapTrackQueryTrackInfoRequest
Definition: AMapTrackHistoryObj.h:140
-[AMapTrackManager stopGaterAndPack]
void stopGaterAndPack()
停止采集和上传,结果会通过onStopGatherAndPack:返回
-[AMapTrackManager stopService]
void stopService()
停止Service,结果会通过onStopService:回调返回
AMapTrackQueryTrackDistanceRequest
行驶距离查询
Definition: AMapTrackHistoryObj.h:47
AMapTrackCommonObj.h
AMapTrackManager::delegate
id< AMapTrackManagerDelegate > delegate
AMapTrackManager的delegate.
Definition: AMapTrackManager.h:31
AMapTrackManager::distanceFilter
CLLocationDistance distanceFilter
设定定位的最小更新距离。单位米,默认为 kCLDistanceFilterNone,表示只要检测到设备位置发生变化就会更新位置信息。
Definition: AMapTrackManager.h:39
AMapTrackQueryLastPointResponse
Definition: AMapTrackHistoryObj.h:37
AMapTrackAddTrackResponse
增加Track请求返回
Definition: AMapTrackTrackObj.h:26
AMapTrackError.h
AMapTrackBaseResponse
AMapTrackKit请求响应基类
Definition: AMapTrackCommonObj.h:41
AMapTrackQueryTrackInfoResponse
Definition: AMapTrackHistoryObj.h:176
AMapTrackQueryTrackDistanceResponse
行驶距离查询返回
Definition: AMapTrackHistoryObj.h:75
AMapTrackManagerOptions.h
-[AMapTrackManager startGatherAndPack]
void startGatherAndPack()
开始采集和上传,结果会通过onStartGatherAndPack:返回
AMapTrackManager::terminalID
NSString * terminalID
当前的terminalID,startService时指定。
Definition: AMapTrackManager.h:72
AMapTrackQueryTerminalResponse
查询Terminal请求返回
Definition: AMapTrackTerminalObj.h:58
AMapTrackManagerOptions
Definition: AMapTrackManagerOptions.h:14
AMapTrackManager::packInterval
NSUInteger packInterval
定位信息的上传周期,单位秒,默认20s,有效值范围[5, 3000]。
Definition: AMapTrackManager.h:57
AMapTrackManager::timeout
NSInteger timeout
网络超时时间,单位秒,默认为30。
Definition: AMapTrackManager.h:113
AMapTrackAddTerminalResponse
增加Terminal请求返回
Definition: AMapTrackTerminalObj.h:29
AMapTrackTrackObj.h
AMapTrackManager::desiredAccuracy
CLLocationAccuracy desiredAccuracy
Definition: AMapTrackManager.h:43
AMapTrackQueryTerminalRequest
查询Terminal请求
Definition: AMapTrackTerminalObj.h:45
AMapTrackManager
Definition: AMapTrackManager.h:26
AMapTrackQueryTrackHistoryAndDistanceResponse
行驶轨迹和距离查询返回
Definition: AMapTrackHistoryObj.h:119
AMapTrackManager::gatherInterval
NSUInteger gatherInterval
定位信息的采集周期,单位秒,默认2s,有效值范围[1, 60]。
Definition: AMapTrackManager.h:54
AMapTrackAddTrackRequest
增加Track请求
Definition: AMapTrackTrackObj.h:16
AMapTrackManager::pausesLocationUpdatesAutomatically
BOOL pausesLocationUpdatesAutomatically
指定定位是否会被系统自动暂停。默认为NO。
Definition: AMapTrackManager.h:46
AMapTrackQueryLastPointRequest
终端位置查询
Definition: AMapTrackHistoryObj.h:22
AMapTrackAddTerminalRequest
增加Terminal请求
Definition: AMapTrackTerminalObj.h:16
AMapTrackQueryTrackHistoryAndDistanceRequest
行驶轨迹和距离查询
Definition: AMapTrackHistoryObj.h:85
AMapTrackManagerServiceOption
Definition: AMapTrackManagerOptions.h:21
-[AMapTrackManagerDelegate-p trackManagerGetCustomDictionary]
NSDictionary< NSString *, NSString * > * trackManagerGetCustomDictionary()
定位点的自定义字段. since 1.1.0
© 2017 高德信息技术有限公司 版权所有,保留所有权利。