| 定位源 | 精度 | 適用場景 | 耗電 |
|---|---|---|---|
| GPS 衛星 | 高 (10-50 米) | 戶外導航、運動追蹤 | 高 |
| Wi-Fi/基站 (網絡定位) | 中 (50-500 米) | 室內、城市密集區、快速定位 | 低 |
Geolocation API 統一封裝上述來源,自動選擇最佳可用源,回調返回:緯度、經度、海拔、精度、方向、速度、時間戳。
import flash.sensors.Geolocation;
import flash.events.GeolocationEvent;
import flash.events.StatusEvent;
private var geo:Geolocation;
public function initGeo():void {
if (Geolocation.isSupported) {
geo = new Geolocation();
geo.setRequestedUpdateInterval(1000); // 1秒更新間隔 (建議值,系統最終決定)
geo.addEventListener(GeolocationEvent.UPDATE, onGeoUpdate);
geo.addEventListener(StatusEvent.STATUS, onGeoStatus);
} else {
trace("設備不支援地理定位");
}
}
private function onGeoUpdate(e:GeolocationEvent):void {
var lat:Number = e.latitude;
var lng:Number = e.longitude;
var alt:Number = e.altitude;
var acc:Number = e.horizontalAccuracy; // 水平精度 (米)
var heading:Number = e.heading; // 方向 (度)
var speed:Number = e.velocity; // 速度 (米/秒)
var time:Date = e.timestamp; // 時間戳
// 更新 UI 或上傳位置
updateLocation(lat, lng, acc);
}
private function onGeoStatus(e:StatusEvent):void {
if (e.code == "PermissionDenied") {
trace("用戶拒絕定位權限");
} else if (e.code == "Unavailable") {
trace("定位暫時不可用 (無 GPS/網絡)");
}
}
<!-- AIR 應用描述文件 app.xml 中聲明 -->
<android>
<manifestAdditions><![CDATA[
<manifest android:installLocation="auto">
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.INTERNET"/> <!-- 網絡定位需聯網 -->
<uses-feature android:name="android.hardware.location.gps" android:required="false"/>
<uses-feature android:name="android.hardware.location.network" android:required="false"/>
</manifest>
]]></manifestAdditions>
</android>
setRequestedUpdateInterval (如導航 1s、打卡 30s、後台追蹤 5min)。GeolocationEvent.UPDATE 與 StatusEvent.STATUS 完整處理成功/失敗/權限狀態。if (accuracy > 1000) return; // 忽略極低精度。Foreground Service (Android 8+),AIR 需用 ANE (Native Extension) 實現。