firstLocationTimeout property

Duration firstLocationTimeout
getter/setter pair

首次定位回调的兜底超时时间,默认 15s。对应 setLocFirstTimeOut(long)

作用于连续定位启动、或单次定位,若在该时间内仍未产生符合 条件的回调,会触发一次兜底回调,返回当前最优定位点;若全程无任何点,则回调 ERROR_FIRST_TIMEOUT(错误码 6)。

firstLocationNeedAddress 为 true 时,该值还会同时作为「等待地址信息」的最长 等待窗口:窗口内出现的无地址点会被暂时忽略;窗口到期仍未拿到地址,则回调当前最优 定位点(可能不带地址)。

不影响单次定位缓存命中时的快速返回路径。

Android 端单次定位的整体超时也由本字段控制。iOS / Harmony 的单次定位超时分别在 iosExtension.singleLocationTimeout / harmonyExtension.singleLocationTimeout 上配置。

Implementation

Duration firstLocationTimeout = const Duration(seconds: 15);