getLocation
获取设备当前的地理位置信息。
扫码预览
支持版本
前端库版本不低于 0.0.28。
支持平台
支持场景
接入准备
权限要求
授权行为
- Android:首次申请位置权限时,调用会先展示应用授权弹窗;同意后如系统定位权限未授予,会继续申请系统权限。拒绝、取消或撤销应用授权后,再次调用不会重复展示应用授权弹窗,而是直接失败;可通过
authorize({ scope: 'scope.userLocation' })重新发起应用授权。系统仍允许询问时会再次申请系统权限;系统不再允许弹出权限申请时,需在系统设置中开启。 - iOS:调用只检查当前的应用授权和系统定位权限,不主动申请权限。任一权限未授予时调用直接失败。调用
authorize({ scope: 'scope.userLocation' })可以重新发起应用授权;系统仍允许询问时会继续申请系统权限,系统不再允许弹出权限申请时会引导用户前往系统设置。
前置条件
- 在应用权限声明中配置
scope.userLocation,并确保系统定位服务已开启 - iOS:调用前通过
authorize({ scope: 'scope.userLocation' })完成应用授权和系统定位权限申请
使用说明
定位信息属于敏感数据,仅在业务确有需要时调用并妥善处理返回结果。
- 避免高频调用,仅在业务确有需要时获取和使用位置信息
调用方式
异步 API
入参
调用示例
成功返回
返回示例
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- Android:用户拒绝应用授权返回 107、系统权限被拒返回 106;定位失败等其他失败统一返回 102。
- iOS:应用授权或系统权限被拒返回 107/106;其他失败(含非法 scope)统一返回 102。
- iOS:mode 为 1 时按高精度模式处理