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

酸奶小妹發表於2015-11-13

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

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

一、如何配置環境?

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>

2、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 和相關許可權

3、程式碼混淆

在生成 apk 進行程式碼混淆時進行如下配置(如果爆出 warning,在報出 warning 的包加入類似的語句:-dontwarn 包名)

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

 

二、如何實現定位?

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

1、定位 SDK簡介

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

支援 Android 4.0 及以上系統。

為保證服務可以正常使用,您需要註冊成為開發者並申請 Key。註冊地址:http://lbs.amap.com/console/

2、配置 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

3、啟動定位功能

高德定位服務包含 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();//銷燬定位客戶端

4、實現"定位小藍點"

下面介紹結合高德地圖 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

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

 

相關文章