萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 平台上使用 Adobe AIR Geolocation API 實現地理定位

定位來源與精度

定位源精度適用場景耗電
GPS 衛星高 (10-50 米)戶外導航、運動追蹤高
Wi-Fi/基站 (網絡定位)中 (50-500 米)室內、城市密集區、快速定位低

Geolocation API 統一封裝上述來源,自動選擇最佳可用源,回調返回:緯度、經度、海拔、精度、方向、速度、時間戳。

核心 API 使用 (ActionScript 3)

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/網絡)");
    }
}

Android 權限配置 (app.xml / AndroidManifest.xml)

<!-- 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>

故障排查清單

  1. 無回調: 檢查權限聲明、用戶是否授權 (Android 6+ 運行時權限)、GPS/網絡開關是否開啟。
  2. 精度極差: 室內優先使用網絡定位,戶外等待 GPS 冷啟動 (首次定位可能需 30-60s),可顯示「正在獲取精確位置...」提示。
  3. 頻繁更新導致耗電: 根據業務調整 setRequestedUpdateInterval (如導航 1s、打卡 30s、後台追蹤 5min)。
  4. 模擬器測試: 使用 Android Studio 模擬器 Extended Controls → Location 注入虛擬 GPS 數據 (GPX/KML 路徑)。
  5. AIR 版本兼容: 確保打包時使用的 AIR SDK 版本 ≥ 2.5,且運行時版本匹配。

最佳實踐建議

  • 結合 GeolocationEvent.UPDATE 與 StatusEvent.STATUS 完整處理成功/失敗/權限狀態。
  • 定位結果按精度過濾:if (accuracy > 1000) return; // 忽略極低精度。
  • 後台定位需啟動 Foreground Service (Android 8+),AIR 需用 ANE (Native Extension) 實現。
  • 隱私合規:明確告知用戶定位用途、頻率、數據去向,提供關閉開關。
copyright © 萬盛學電腦網 all rights reserved