Skip to content

CLLocationManager:requestLocation() 方法 ​

requestLocation() 方法取一次当前的位置。系统按 desiredAccuracy 去定位,拿到一个位置之后自己停下。

语法 ​

requestLocation()

参数 ​

无。

返回值 ​

Promise,兑现成一个 CLLocation。

  • 通常要几秒。耗时和超时未在模拟器验证。
  • 上一次还没结算时再调一次,系统只定位一次,两个 Promise 得到同一个结果。
  • 取到位置时也派发一次 locationupdate。

Promise 被拒绝时得到 CLLocationError:

name什么时候
'NotAllowedError'授权状态不是 'authorizedWhenInUse' 或 'authorizedAlways'。当场拒绝,不弹提示框,不等待。code 是 1,domain 是 'kCLErrorDomain'
'InvalidStateError'这个 manager 正在连续更新
'AbortError'结算之前调了 startUpdatingLocation() 或 stopUpdatingLocation()
'LocationUnknownError'系统定不出位置。模拟器上没有设位置时就是这样。未在模拟器验证
'NetworkError'、'CLError'系统报告的其他错误,code 是系统的错误码。未在模拟器验证

'NotAllowedError' 的 message:还没申请过时是 requestLocation: location authorization has not been requested yet; call requestWhenInUseAuthorization() first;其他状态是 requestLocation: location access is denied 这样,最后一个词是当前的状态。

'InvalidStateError' 的 message:requestLocation: location updates are running; read the locationupdate event instead, or call stopUpdatingLocation() first。

'AbortError' 的 message:requestLocation was cancelled by 加上取消它的方法名。

异常 ​

无。出错都从 Promise 拒绝。

说明 ​

只要一个位置时用它,不用记得关。要跟着用户移动,用 startUpdatingLocation()。

示例 ​

js
const manager = new CLLocationManager();
manager.requestLocation().then(
  (here) => {
    console.log(here.coordinate.latitude, here.coordinate.longitude);
  },
  (err) => {
    console.log('没取到:' + err.name);
  });

效果:取到时输出纬度和经度两个数。没取到时输出 没取到: 加错误的名字。没有授权时输出 没取到:NotAllowedError。

对应的 iOS API ​

-[CLLocationManager requestLocation]。ObjC 里结果从委托的 locationManager:didUpdateLocations: 或 locationManager:didFailWithError: 来,这里从返回的 Promise 来。

参见 ​