startSingleLocation method

Future<TencentLocation> startSingleLocation(
  1. TencentLocationRequest request
)

请求单次定位。结果直接由返回的 Future 发出，不经过 onLocationChanged。

超时会抛出 TencentLocationError（错误码 timeout）；失败抛出 locationFailed。

Platforms:

  • 🅰️ Android：支持
  • 🍏 iOS：支持
  • 🔶 Harmony：支持

Parameters:

  • request：单次定位请求参数。超时时长由各平台扩展字段控制： Android 走 androidExtension.firstLocationTimeout（默认 15s）， iOS 走 iosExtension.singleLocationTimeout（默认 10s）， Harmony 走 harmonyExtension.singleLocationTimeout（默认 10s）。

Returns:

  • 单次定位的结果。

Implementation

Future<TencentLocation> startSingleLocation(TencentLocationRequest request) =>
    _after(() => _platform.startSingleLocation(_id, request));