startLocationUpdate
开始接收位置更新。
使用限制
WARNING
iOS:省略 type 时调用失败;iOS 调用方必须显式传入 type。
支持版本
前端库版本不低于 0.0.32。
支持平台
支持场景
接入准备
权限要求
授权行为
- Android:调用会主动申请应用位置授权和系统定位权限,并以尽力而为方式申请后台定位授权。拒绝、取消或撤销应用授权后,再次调用直接失败;可通过
authorize({ scope: 'scope.userLocation' })重新发起。后台定位授权失败不阻断启动。 - iOS:调用会主动申请应用位置授权和系统定位权限,并继续尝试后台定位授权。已拒绝或撤销后再次调用直接失败;可通过
authorize({ scope: 'scope.userLocation' })重新发起。后台定位授权失败不阻断启动。
前置条件
- 在应用权限声明中配置
scope.userLocation,并确保系统定位服务已开启
使用说明
需配对调用 stopLocationUpdate。
- 建议在启动前注册
onLocationChange和onLocationChangeError;不再需要更新时及时调用stopLocationUpdate - iOS:调用时必须显式传入 type
scope.userLocationBackground为后台定位授权;豆包会尝试申请,申请失败不阻断本次启动- 定位信息属于敏感数据,仅在业务确有需要时持续获取和使用;事件回调频率不固定
调用方式
异步 API
入参
调用示例
成功返回
无返回字段。
返回示例
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- Android:用户拒绝授权返回 1700001、取消返回 114、授权网络失败返回 1700002;当前豆包客户端不支持持续定位时返回 103;其他失败统一返回 102。
- iOS:用户拒绝授权返回 1700001、取消返回 114、授权网络失败返回 1700002、非法 scope 返回 104;当前豆包客户端不支持持续定位时返回 103;其他失败统一返回 102。