高德地图iOS SDK 2D地图参考手册 V4.2.0
|
#import <AMapLocationManager.h>
Instance Methods | |
(BOOL) | - requestLocationWithReGeocode:completionBlock: |
(void) | - startUpdatingLocation |
(void) | - stopUpdatingLocation |
(void) | - startMonitoringForRegion: |
(void) | - stopMonitoringForRegion: |
(void) | - requestStateForRegion: |
属性 | |
id< AMapLocationManagerDelegate > | delegate |
CLLocationDistance | distanceFilter |
CLLocationAccuracy | desiredAccuracy |
BOOL | pausesLocationUpdatesAutomatically |
BOOL | allowsBackgroundLocationUpdates |
NSInteger | locationTimeout |
NSInteger | reGeocodeTimeout |
NSSet * | monitoredRegions |
AMapLocationManager类
初始化之前请设置 AMapLocationServices 中的APIKey,否则将无法正常使用服务.
- (BOOL) requestLocationWithReGeocode: | (BOOL) | withReGeocode | |
completionBlock: | (AMapLocatingCompletionBlock) | completionBlock | |
单次定位
如果当前正在连续定位,调用此方法将会失败,返回NO。
该方法将会根据设定的 desiredAccuracy 去获取定位信息。 如果获取的定位信息精确度低于 desiredAccuracy ,将会持续的等待定位信息,直到超时后通过completionBlock返回精度最高的定位信息。
可以通过 stopUpdatingLocation 方法去取消正在进行的单次定位请求。
withReGeocode | 是否带有逆地理信息(获取逆地理信息需要联网) |
completionBlock | 单次定位完成后的Block |
- (void) requestStateForRegion: | (AMapLocationRegion *) | region |
查询一个region的当前状态
查询结果通过amapLocationManager:didDetermineState:forRegion:回调返回
region | 要查询的region |
- (void) startMonitoringForRegion: | (AMapLocationRegion *) | region |
开始监控指定的region
如果已经存在相同identifier的region,则之前的region将会被移除。 对 AMapLocationCircleRegion 类实例,将会优先监控radius小的region。
region | 要被监控的范围 |
- (void) startUpdatingLocation |
开始连续定位
调用此方法会cancel掉所有的单次定位请求。
- (void) stopMonitoringForRegion: | (AMapLocationRegion *) | region |
停止监控指定的region
region | 要停止监控的范围 |
- (void) stopUpdatingLocation |
停止连续定位
调用此方法会cancel掉所有的单次定位请求,可以用来取消单次定位。
|
readwritenonatomicassign |
是否允许后台定位。默认为NO。只在iOS 9.0及之后起作用。
设置为YES的时候必须保证 Background Modes 中的 Location updates 处于选中状态,否则会抛出异常。
|
readwritenonatomicweak |
实现了 AMapLocationManagerDelegate 协议的类指针。
|
readwritenonatomicassign |
设定定位精度。默认为 kCLLocationAccuracyBest 。
|
readwritenonatomicassign |
设定定位的最小更新距离。默认为 kCLDistanceFilterNone 。
|
readwritenonatomicassign |
指定单次定位超时时间,默认为10s。最小值是2s。注意单次定位请求前设置。
|
readnonatomiccopy |
获取被监控的region集合
|
readwritenonatomicassign |
指定定位是否会被系统自动暂停。默认为YES。
|
readwritenonatomicassign |
指定单次定位逆地理超时时间,默认为5s。最小值是2s。注意单次定位请求前设置。