本文詳細講解了如何配置環境,如何實現定位,以及公佈了定位程式碼。
-----------------------------------------------------------------------
一、如何配置環境?
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
---------------------------------------------------------------------------------------------------------------------------------