firstLocationTimeout property
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);