目录

HMSLocationManagerDelegate

Class info

@protocol HMSLocationManagerDelegate <NSObject>

定位管理类HMSLocationManager的代理类。

Public Method Summary

Public Methods

[h2]HMSLocationManager:didChangeAuthorizationStatus:

Method

@optional

- (void) HMSLocationManager:(HMSLocationManager *)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status;

定位权限变更回调。创建定位管理类4.2.2.7-HMSLocationManager时也会触发。

如果在调用requestWhenInUseAuthorization或requestAlwaysAuthorization方法后用户的选择没有更改授权状态,则不会触发此代理的回调。

导致授权状态更改的事件

  • 在设置>隐私>定位服务或设置>应用程序>定位服务中更改应用程序的位置授权。
  • 在设置>隐私>定位服务中打开或关闭手机的定位服务功能。
  • 在设置>通用>还原中选择“重要位置和隐私”。
  • 用户对授权状态的弹窗的响应行为。

应用程序具有临时授权时,当用户停止使用该应用程序,授权会发生变化。

Parameters

Name

Description

manager

管理类对象。

status

权限类型。

[h2]HMSLocationManager:didFailWithError:

Method

@optional

- (void)HMSLocationManager:(HMSLocationManager *)manager didFailWithError:(NSError *)error;

API请求的失败回调。

如果不实现此方法,定位会在尝试使用定位服务时会抛出异常。

定位管理对象在获取朝向信息、地理编码信息和位置信息时发生错误都会调用此方法。特别的,如果是位置服务无法立即检索位置,它将报告10000错误并继续尝试。在这种情况下,您可以忽略错误并等待下一个事件。如果由于附近磁场的强烈干扰而无法确定航向,此方法也将返回10000错误。

Parameters

Name

Description

manager

管理类对象。

error

错误信息。

[h2]HMSLocationManager:didUpdateHeading:

Method

@optional

- (void) HMSLocationManager:(HMSLocationManager *)manager didUpdateHeading:(CLHeading *)newHeading;

朝向更新回调。

如果您调用startUpdatingHeading方法,则应使用本方法来接收回调。只有当上一次的朝向属性值与当前朝向属性值之差的绝对值超过设置的headingFilter属性值时,才会触发回调。

Parameters

Name

Description

manager

管理类对象。

newHeading

新的朝向信息。

[h2]HMSLocationManager:didUpdateLocation:

Method

@optional

- (void) HMSLocationManager:(HMSLocationManager *)manager didUpdateLocation:(HMSLoc *)location;

位置更新回调。

Parameters

Name

Description

manager

管理类对象。

location

最新的位置信息。

[h2]HMSLocationManagerShouldDisplayHeadingCalibration:

Method

@optional

- (BOOL) HMSLocationManagerShouldDisplayHeadingCalibration:(HMSLocationManager *)manager;

是否显示朝向校准警告。

此方法可以用来校准获取朝向的硬件设备。通常位置服务会在以下情形调用此方法:

  • 首次请求朝向信息更新。
  • 当位置服务检测到所观测磁场的大小或者倾角发生重大变化时。

如果此方法返回YES,位置服务会立即在当前窗口顶部显示航向校准警告。校准警告提示用户以特定模式移动设备,以便位置服务能够区分地球磁场和任何局部磁场。该警告会一直保持可见状态,直到校准完成或通过显示调用dismissHeadingCalibrationDisplay方法来移除警告。校准过程只能过滤掉随设备移动的磁场。要校准靠近其他磁干扰源的设备,用户必须在校准过程中将设备从源移开或与设备一起移动源。

此方法返回NO或者未在代理中实现该方法,则不会显示朝向校准警告。当设备上的干扰磁场移除或产生较大变化时,校准仍会自动发生。

Parameters

Name

Description

manager

管理类对象。

Return

Type

Description

BOOL

返回是否显示朝向校准警告。

  • YES:显示朝向校准警告。
  • NO:不显示朝向校准警告。

[h2]onGeocodeSearchDone:

Method

@optional

- (void) onGeocodeSearchDone:(NSArray<HMSLoc *>*)requestArray;

正地理编码的回调方法,返回值仅包含HMSLoc的数组,默认值为nil。如果调用失败会调用HMSLocationManager:didFailWithError:回调方法。

Parameters

Name

Description

requestArray

包含HMSLoc的数组。

[h2]onReGeocodeSearchDone:

Method

@optional

- (void) onReGeocodeSearchDone:(NSArray<HMSLoc *>*)requestArray;

逆地理编码的回调方法,返回仅包含HMSLoc的数组,默认值为nil。如果调用失败会调用HMSLocationManager:didFailWithError:回调方法。

Parameters

Name

Description

requestArray

包含HMSLoc的数组。