【從零開始學】如何在安卓平臺上實現定位？

本文詳細講解了如何配置環境，如何實現定位，以及公佈了定位代碼。

-----------------------------------------------------------------------

1、如何配置環境？

一、Eclipse 的配置

下載 jar 包以後，在開發工程中新建「libs」文件夾，將定位包拷貝到 libs 的根目錄下。拷貝完成後的工程目錄(以 V1.0.4 爲例)如圖所示：

注意：若您在 Eclipse 上使用 adt22 版本插件，則須要在 Eclipse 上進行以下配置：

選中 Eclipse 的工程，右鍵選擇 「Properties > Java Build Path > Order and Export」，勾選 「Android Private Libraries」。

工程的「AndroidManifest.xml」文件以下代碼中添加您的用戶 Key。

<application
 android:icon="@drawable/icon"
 android:label="@string/app_name" >
 <meta-data
 android:name="com.amap.api.v2.apikey"
 android:value="請輸入您的用戶 Key" />
 <activity android:name="com.amap.demo.LocationManager" >
 <intent-filter>
 <action android:name="android.intent.action.MAIN" />
 <category android:name="android.intent.category.LAUNCHER" />
 </intent-filter>
 </activity>
</application>

二、Android Studio 配置工程

新建工程如圖所示：

在工程的 app/libs 目錄下放入已經下載的開發包，這裏以 3D 地圖爲例，將開發包中的 jar 包加到 libs 目錄下，如圖所示：

選擇放到 libs 下的 jar 包，右擊選擇 Add As Library

由於 3D 地圖 SDK 和導航 SDK 須要引入 so 庫文件，全部須要再 app/src/main/目錄下新建 jniLibs 目錄，將 so 放到此目錄下，如圖所 示：

在 app/src/main 目錄下的 AndroidMainfest.xml 配置申請的 key 和相關權限

三、代碼混淆

在生成 apk 進行代碼混淆時進行以下配置(若是爆出 warning，在報出 warning 的包加入相似的語句：-dontwarn 包名)

定位
 -keep class com.amap.api.location.**{*;}
 -keep class com.aps.**{*;}

 

2、如何實現定位？

使用定位SDK便可實現定位。下載連接http://lbs.amap.com/api/android-location-sdk/down/ 

一、定位 SDK簡介

Android 定位 SDK 是一套簡單的 LBS 服務定位接口，您可使用這套定位 API 獲取定位結果（包括全球定位、輔助 H5 頁面定位功能）、逆 地理編碼（地址的文字描述）、以及地理圍欄功能。

支持 Android 4.0 及以上系統。

爲保證服務能夠正常使用，您須要註冊成爲開發者並申請 Key。註冊地址：http://lbs.amap.com/console/

二、配置 AndroidManifest.xml

首先，請在在 application 標籤中聲明 service 組件,每一個 app 擁有本身單獨的定位 service。

<service android:name="com.amap.api.location.APSService"></service>

聲明使用權限

<!--用於進行網絡定位-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!--用於訪問 GPS 定位-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 獲取運營商信息，用於支持提供運營商信息相關的接口-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 用於訪問 wifi 網絡信息，wifi 信息會用於進行網絡定位-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 這個權限用於獲取 wifi 的獲取權限，wifi 信息會用來進行網絡定位-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<!--用於訪問網絡，網絡定位須要上網-->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 用於讀取手機當前的狀態-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 寫入擴展存儲，向擴展卡寫入數據，用於寫入緩存定位數據-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

設置 Key，在 application 標籤中加入

<meta-data
 android:name="com.amap.api.v2.apikey"
 android:value="key" /> //開發者申請的 key

三、啓動定位功能

高德定位服務包含 GPS 和網絡定位（Wi-Fi 和基站定位）兩種能力。定位 SDK 將 GPS、網絡定位能力進行了封裝，以三種定位模式對外開放。

高精度定位模式：會同時使用網絡定位和 GPS 定位，優先返回最高精度的定位結果；

低功耗定位模式：不會使用 GPS，只會使用網絡定位（Wi-Fi 和基站定位）；

僅用設備定位模式：不須要鏈接網絡，只使用 GPS 進行定位，這種模式下不支持室內環境的定位。

第一步，初始化定位客戶端

注：請在主線程中聲明 AMapLocationClient 類對象，須要傳 Context 類型的參數。推薦用 getApplicationConext()方法獲取全進程有效的 context。

//聲明AMapLocationClient類對象
public AMapLocationClient mLocationClient = null;
//聲明定位回調監聽器
public AMapLocationListener mLocationListener = new AMapLocationListener();
//初始化定位
mLocationClient = new AMapLocationClient(getApplicationContext());
//設置定位回調監聽
mlocationClient.setLocationListener(mLocationListener);

第二步，配置定位參數，啓動定位

設置定位參數包括：定位模式（高精度定位模式，低功耗定位模式和僅設備定位模式），是否返回地址信息等。

//聲明mLocationOption對象
public AMapLocationOption mLocationOption = null;
//初始化定位參數
mLocationOption = new AMapLocationClientOption();
//設置定位模式爲高精度模式，Battery_Saving爲低功耗模式，Device_Sensors是僅設備模
式
mLocationOption.setLocationMode(AMapLocationMode.Hight_Accuracy);
//設置是否返回地址信息（默認返回地址信息）
mLocationOption.setNeedAddress(true);
 //設置是否只定位一次,默認爲false
mLocationOption.setOnceLocation(false);
//設置是否強制刷新WIFI，默認爲強制刷新
mLocationOption.setWifiActiveScan(true);
//設置是否容許模擬位置,默認爲false，不容許模擬位置
mLocationOption.setMockEnable(false);
//設置定位間隔,單位毫秒,默認爲2000ms
mLocationOption.setInterval(2000);
//給定位客戶端對象設置定位參數
mlocationClient.setLocationOption(mLocationOption);
 //啓動定位
mlocationClient.startLocation();

第三步，實現 AMapLocationListener 接口，獲取定位結果 AMapLocationListener

接口只有 onLocationChanged 方法能夠實現，用於接收異步返回的定位結果，參數是 AMapLocation 類型。

public void onLocationChanged(AMapLocation amapLocation) {
if (amapLocation != null) {
if (amapLocation.getErrorCode() == 0) {
//定位成功回調信息，設置相關消息
amapLocation.getLocationType();//獲取當前定位結果來源，如網絡定位結果，
詳見定位類型表
amapLocation.getLatitude();//獲取經度
amapLocation.getLongitude();//獲取緯度
amapLocation.getAccuracy();//獲取精度信息
SimpleDateFormat df = new SimpleDateFormat(
"yyyy-MM-dd HH:mm:ss");
Date date = new Date(amapLocation.getTime());
 df.format(date);//定位時間
amapLocation.getAddress();//地址，若是option中設置isNeedAddress爲
false，則沒有此結果
amapLocation.getCountry();//國家信息
amapLocation.getProvince();//省信息
amapLocation.getCity();//城市信息
amapLocation.getDistrict();//城區信息
amapLocation.getRoad();//街道信息
amapLocation.getCityCode();//城市編碼
amapLocation.getAdCode();//地區編碼
} else {
 //顯示錯誤信息ErrCode是錯誤碼，errInfo是錯誤信息，詳見錯誤碼錶。
Log.e("AmapError",
"location Error, ErrCode:"
+ amapLocation.getErrorCode() + ", errInfo:"
+ amapLocation.getErrorInfo());
}
}
}

中止定位：

mlocationClient.stopLocation();//中止定位

銷燬定位客戶端：

mlocationClient. onDestroy();//銷燬定位客戶端

四、實現"定位小藍點"

下面介紹結合高德地圖 Android SDK，介紹如何顯示定位小藍點（詳細信息，請參考com.location.apis.demo.MyLocationActivity.java）：

/**
 * AMap地圖中簡單介紹顯示定位小藍點
 */
public class MultyLocationActivity extends Activity implements LocationSource, AMapLocationListener {
    private AMap aMap;
    private MapView mapView;
    private OnLocationChangedListener mListener;
    private LocationManagerProxy mAMapLocationManager;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.locationsource_activity);
        mapView = (MapView) findViewById(R.id.map);
        mapView.onCreate(savedInstanceState);
        init();
    }
    /**
     * 初始化AMap對象
     */
    private void init() {
        if (aMap == null) {
            aMap = mapView.getMap();
            setUpMap();
        }
    }
    private void setUpMap() {
        aMap.setLocationSource(this);// 設置定位監聽
        aMap.getUiSettings().setMyLocationButtonEnabled(true);// 設置默認定位按鈕是否顯示
        aMap.setMyLocationEnabled(true);// 設置爲true表示顯示定位層並可觸發定位，false表示隱藏定位層並不可觸發定位，默認是false
        // 設置定位的類型爲定位模式：定位（AMap.LOCATION_TYPE_LOCATE）、跟隨（AMap.LOCATION_TYPE_MAP_FOLLOW）
        // 地圖根據面向方向旋轉（AMap.LOCATION_TYPE_MAP_ROTATE）三種模式
        aMap.setMyLocationType(AMap.LOCATION_TYPE_LOCATE);
    }
    @Override
    protected void onResume() {
        super.onResume();
        mapView.onResume();
    }
    @Override
    protected void onPause() {
        super.onPause();
        mapView.onPause();
        deactivate();
    }
    @Override
    protected void onDestroy() {
        super.onDestroy();
        mapView.onDestroy();
    }
     
    /**
     * 定位成功後回調函數
     */
    @Override
    public void onLocationChanged(AMapLocation amapLocation) {
        if (mListener != null && amapLocation != null) {
            if (amapLocation.getAMapException().getErrorCode() == 0) {
                mListener.onLocationChanged(amapLocation);// 顯示系統小藍點
            }
        }
    }
    /**
     * 激活定位
     */
    @Override
    public void activate(OnLocationChangedListener listener) {
        mListener = listener;
        if (mAMapLocationManager == null) {
            mAMapLocationManager = LocationManagerProxy.getInstance(this);
            //此方法爲每隔固定時間會發起一次定位請求，爲了減小電量消耗或網絡流量消耗，
            //注意設置合適的定位時間的間隔，而且在合適時間調用removeUpdates()方法來取消定位請求
            //在定位結束後，在合適的生命週期調用destroy()方法     
            //其中若是間隔時間爲-1，則定位只定一次
            mAMapLocationManager.requestLocationData(
                    LocationProviderProxy.AMapNetwork, 60*1000, 10, this);
        }
    }
    /**
     * 中止定位
     */
    @Override
    public void deactivate() {
        mListener = null;
        if (mAMapLocationManager != null) {
            mAMapLocationManager.removeUpdates(this);
            mAMapLocationManager.destroy();
        }
        mAMapLocationManager = null;
    }
}

 

其餘注意事項

目前手機設備在長時間黑屏或鎖屏時 CPU 會休眠，這致使定位 SDK 不能正常進行位置更新。若您有鎖屏狀態下獲取位置的需求，您能夠應 用 alarmManager 實現 1 個可叫醒 CPU 的 Timer，定時請求定位。

使用定位 SDK 務必要註冊 GPS 和網絡的使用權限。

在使用定位 SDK 時，請儘可能保證網絡暢通，如獲取網絡定位，地址信息等都須要設備能夠正常接入網絡。

定位 SDK 在國內返回 gcj02 類型座標，海外定位將返回原始座標。

由於僅設備定位（經過 GPS 定位）是設備本地定位行爲，是不返回地址信息的。

 

---------------------------------------------------------------------------------------------------------------------------------

即日起至2016/10/31止，凡註冊成爲高德開發者的新用戶，便可獲贈1張阿里雲優惠券，可享受最低6折購買阿里雲產品。數量有限，發完即止。詳情點擊：http://lbsbbs.amap.com/forum.php?mod=viewthread&tid=20143

---------------------------------------------------------------------------------------------------------------------------------