Class info |
|---|
@protocol HMSLocationManagerDelegate <NSObject> 定位管理类HMSLocationManager的代理类。 |
Qualifier and Type | Method name and Description |
|---|---|
void | 定位权限变更回调。 |
void | HMSLocationManager:(HMSLocationManager *)manager didFailWithError:(NSError *)error 定位失败回调。 |
void | HMSLocationManager:(HMSLocationManager *)manager didUpdateHeading:(CLHeading *)newHeading 朝向更新回调。 |
void | HMSLocationManager:(HMSLocationManager *)manager didUpdateLocation:(HMSLoc *)location 位置更新回调。 |
BOOL | HMSLocationManagerShouldDisplayHeadingCalibration:(HMSLocationManager *)manager 是否显示朝向校准警告。 |
Method |
|---|
@optional - (void) HMSLocationManager:(HMSLocationManager *)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status; 定位权限变更回调。创建定位管理类4.2.2.7-HMSLocationManager时也会触发。 如果在调用requestWhenInUseAuthorization或requestAlwaysAuthorization方法后用户的选择没有更改授权状态,则不会触发此代理的回调。 导致授权状态更改的事件
应用程序具有临时授权时,当用户停止使用该应用程序,授权会发生变化。 |
Parameters
Name | Description |
|---|---|
manager | 管理类对象。 |
status | 权限类型。 |
Method |
|---|
@optional - (void)HMSLocationManager:(HMSLocationManager *)manager didFailWithError:(NSError *)error; API请求的失败回调。 如果不实现此方法,定位会在尝试使用定位服务时会抛出异常。 定位管理对象在获取朝向信息、地理编码信息和位置信息时发生错误都会调用此方法。特别的,如果是位置服务无法立即检索位置,它将报告10000错误并继续尝试。在这种情况下,您可以忽略错误并等待下一个事件。如果由于附近磁场的强烈干扰而无法确定航向,此方法也将返回10000错误。 |
Parameters
Name | Description |
|---|---|
manager | 管理类对象。 |
error | 错误信息。 |
Method |
|---|
@optional - (void) HMSLocationManager:(HMSLocationManager *)manager didUpdateHeading:(CLHeading *)newHeading; 朝向更新回调。 如果您调用startUpdatingHeading方法,则应使用本方法来接收回调。只有当上一次的朝向属性值与当前朝向属性值之差的绝对值超过设置的headingFilter属性值时,才会触发回调。 |
Parameters
Name | Description |
|---|---|
manager | 管理类对象。 |
newHeading | 新的朝向信息。 |
Method |
|---|
@optional - (void) HMSLocationManager:(HMSLocationManager *)manager didUpdateLocation:(HMSLoc *)location; 位置更新回调。 |
Parameters
Name | Description |
|---|---|
manager | 管理类对象。 |
location | 最新的位置信息。 |
Method |
|---|
@optional - (BOOL) HMSLocationManagerShouldDisplayHeadingCalibration:(HMSLocationManager *)manager; 是否显示朝向校准警告。 此方法可以用来校准获取朝向的硬件设备。通常位置服务会在以下情形调用此方法:
如果此方法返回YES,位置服务会立即在当前窗口顶部显示航向校准警告。校准警告提示用户以特定模式移动设备,以便位置服务能够区分地球磁场和任何局部磁场。该警告会一直保持可见状态,直到校准完成或通过显示调用dismissHeadingCalibrationDisplay方法来移除警告。校准过程只能过滤掉随设备移动的磁场。要校准靠近其他磁干扰源的设备,用户必须在校准过程中将设备从源移开或与设备一起移动源。 此方法返回NO或者未在代理中实现该方法,则不会显示朝向校准警告。当设备上的干扰磁场移除或产生较大变化时,校准仍会自动发生。 |
Parameters
Name | Description |
|---|---|
manager | 管理类对象。 |
Return
Type | Description |
|---|---|
BOOL | 返回是否显示朝向校准警告。
|
Method |
|---|
@optional - (void) onGeocodeSearchDone:(NSArray<HMSLoc *>*)requestArray; 正地理编码的回调方法,返回值仅包含HMSLoc的数组,默认值为nil。如果调用失败会调用HMSLocationManager:didFailWithError:回调方法。 |
Parameters
Name | Description |
|---|---|
requestArray | 包含HMSLoc的数组。 |
Method |
|---|
@optional - (void) onReGeocodeSearchDone:(NSArray<HMSLoc *>*)requestArray; 逆地理编码的回调方法,返回仅包含HMSLoc的数组,默认值为nil。如果调用失败会调用HMSLocationManager:didFailWithError:回调方法。 |
Parameters
Name | Description |
|---|---|
requestArray | 包含HMSLoc的数组。 |