【從零開始學(xué)】如何在安卓平臺(tái)上實(shí)現(xiàn)定位?本文詳細(xì)講解了如何配置環(huán)境,如何實(shí)現(xiàn)定位,以及公布了定位代碼。 ----------------------------------------------------------------------- 一、如何配置環(huán)境?1、Eclipse 的配置下載 jar 包之后,在開發(fā)工程中新建“l(fā)ibs”文件夾,將定位包拷貝到 libs 的根目錄下。拷貝完成后的工程目錄(以 V1.0.4 為例)如圖所示:
注意:若您在 Eclipse 上使用 adt22 版本插件,則需要在 Eclipse 上進(jìn)行如下配置: 選中 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="請(qǐng)輸入您的用戶 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 目錄下放入已經(jīng)下載的開發(fā)包,這里以 3D 地圖為例,將開發(fā)包中的 jar 包加到 libs 目錄下,如圖所示:
選擇放到 libs 下的 jar 包,右擊選擇 Add As Library
因?yàn)?3D 地圖 SDK 和導(dǎo)航 SDK 需要引入 so 庫(kù)文件,所有需要再 app/src/main/目錄下新建 jniLibs 目錄,將 so 放到此目錄下,如圖所 示:
在 app/src/main 目錄下的 AndroidMainfest.xml 配置申請(qǐng)的 key 和相關(guān)權(quán)限
3、代碼混淆在生成 apk 進(jìn)行代碼混淆時(shí)進(jìn)行如下配置(如果爆出 warning,在報(bào)出 warning 的包加入類似的語(yǔ)句:-dontwarn 包名) 定位 -keep class com.amap.api.location.**{*;} -keep class com.aps.**{*;}
二、如何實(shí)現(xiàn)定位?使用定位SDK即可實(shí)現(xiàn)定位。下載鏈接http://lbs.amap.com/api/android-location-sdk/down/ 1、定位 SDK簡(jiǎn)介Android 定位 SDK 是一套簡(jiǎn)單的 LBS 服務(wù)定位接口,您可以使用這套定位 API 獲取定位結(jié)果(包括全球定位、輔助 H5 頁(yè)面定位功能)、逆 地理編碼(地址的文字描述)、以及地理圍欄功能。 支持 Android 4.0 及以上系統(tǒng)。 為保證服務(wù)可以正常使用,您需要注冊(cè)成為開發(fā)者并申請(qǐng) Key。注冊(cè)地址:http://lbs.amap.com/console/ 2、配置 AndroidManifest.xml首先,請(qǐng)?jiān)谠?application 標(biāo)簽中聲明 service 組件,每個(gè) app 擁有自己?jiǎn)为?dú)的定位 service。 <service android:name="com.amap.api.location.APSService"></service> 聲明使用權(quán)限 <!--用于進(jìn)行網(wǎng)絡(luò)定位--> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!--用于訪問 GPS 定位--> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- 獲取運(yùn)營(yíng)商信息,用于支持提供運(yùn)營(yíng)商信息相關(guān)的接口--> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 用于訪問 wifi 網(wǎng)絡(luò)信息,wifi 信息會(huì)用于進(jìn)行網(wǎng)絡(luò)定位--> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!-- 這個(gè)權(quán)限用于獲取 wifi 的獲取權(quán)限,wifi 信息會(huì)用來進(jìn)行網(wǎng)絡(luò)定位--> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <!--用于訪問網(wǎng)絡(luò),網(wǎng)絡(luò)定位需要上網(wǎng)--> <uses-permission android:name="android.permission.INTERNET" /> <!-- 用于讀取手機(jī)當(dāng)前的狀態(tài)--> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <!-- 寫入擴(kuò)展存儲(chǔ),向擴(kuò)展卡寫入數(shù)據(jù),用于寫入緩存定位數(shù)據(jù)--> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 設(shè)置 Key,在 application 標(biāo)簽中加入 <meta-data android:name="com.amap.api.v2.apikey" android:value="key" /> //開發(fā)者申請(qǐng)的 key 3、啟動(dòng)定位功能高德定位服務(wù)包含 GPS 和網(wǎng)絡(luò)定位(Wi-Fi 和基站定位)兩種能力。定位 SDK 將 GPS、網(wǎng)絡(luò)定位能力進(jìn)行了封裝,以三種定位模式對(duì)外開放。 高精度定位模式:會(huì)同時(shí)使用網(wǎng)絡(luò)定位和 GPS 定位,優(yōu)先返回最高精度的定位結(jié)果; 低功耗定位模式:不會(huì)使用 GPS,只會(huì)使用網(wǎng)絡(luò)定位(Wi-Fi 和基站定位); 僅用設(shè)備定位模式:不需要連接網(wǎng)絡(luò),只使用 GPS 進(jìn)行定位,這種模式下不支持室內(nèi)環(huán)境的定位。 第一步,初始化定位客戶端注:請(qǐng)?jiān)谥骶€程中聲明 AMapLocationClient 類對(duì)象,需要傳 Context 類型的參數(shù)。推薦用 getApplicationConext()方法獲取全進(jìn)程有效的 context。 //聲明AMapLocationClient類對(duì)象 public AMapLocationClient mLocationClient = null; //聲明定位回調(diào)監(jiān)聽器 public AMapLocationListener mLocationListener = new AMapLocationListener(); //初始化定位 mLocationClient = new AMapLocationClient(getApplicationContext()); //設(shè)置定位回調(diào)監(jiān)聽 mlocationClient.setLocationListener(mLocationListener); 第二步,配置定位參數(shù),啟動(dòng)定位設(shè)置定位參數(shù)包括:定位模式(高精度定位模式,低功耗定位模式和僅設(shè)備定位模式),是否返回地址信息等。 //聲明mLocationOption對(duì)象 public AMapLocationOption mLocationOption = null; //初始化定位參數(shù) mLocationOption = new AMapLocationClientOption(); //設(shè)置定位模式為高精度模式,Battery_Saving為低功耗模式,Device_Sensors是僅設(shè)備模 式 mLocationOption.setLocationMode(AMapLocationMode.Hight_Accuracy); //設(shè)置是否返回地址信息(默認(rèn)返回地址信息) mLocationOption.setNeedAddress(true); //設(shè)置是否只定位一次,默認(rèn)為false mLocationOption.setOnceLocation(false); //設(shè)置是否強(qiáng)制刷新WIFI,默認(rèn)為強(qiáng)制刷新 mLocationOption.setWifiActiveScan(true); //設(shè)置是否允許模擬位置,默認(rèn)為false,不允許模擬位置 mLocationOption.setMockEnable(false); //設(shè)置定位間隔,單位毫秒,默認(rèn)為2000ms mLocationOption.setInterval(2000); //給定位客戶端對(duì)象設(shè)置定位參數(shù) mlocationClient.setLocationOption(mLocationOption); //啟動(dòng)定位 mlocationClient.startLocation(); 第三步,實(shí)現(xiàn) AMapLocationListener 接口,獲取定位結(jié)果 AMapLocationListener接口只有 onLocationChanged 方法可以實(shí)現(xiàn),用于接收異步返回的定位結(jié)果,參數(shù)是 AMapLocation 類型。 public void onLocationChanged(AMapLocation amapLocation) { if (amapLocation != null) { if (amapLocation.getErrorCode() == 0) { //定位成功回調(diào)信息,設(shè)置相關(guān)消息 amapLocation.getLocationType();//獲取當(dāng)前定位結(jié)果來源,如網(wǎng)絡(luò)定位結(jié)果, 詳見定位類型表 amapLocation.getLatitude();//獲取經(jīng)度 amapLocation.getLongitude();//獲取緯度 amapLocation.getAccuracy();//獲取精度信息 SimpleDateFormat df = new SimpleDateFormat( "yyyy-MM-dd HH:mm:ss"); Date date = new Date(amapLocation.getTime()); df.format(date);//定位時(shí)間 amapLocation.getAddress();//地址,如果option中設(shè)置isNeedAddress為 false,則沒有此結(jié)果 amapLocation.getCountry();//國(guó)家信息 amapLocation.getProvince();//省信息 amapLocation.getCity();//城市信息 amapLocation.getDistrict();//城區(qū)信息 amapLocation.getRoad();//街道信息 amapLocation.getCityCode();//城市編碼 amapLocation.getAdCode();//地區(qū)編碼 } else { //顯示錯(cuò)誤信息ErrCode是錯(cuò)誤碼,errInfo是錯(cuò)誤信息,詳見錯(cuò)誤碼表。 Log.e("AmapError", "location Error, ErrCode:" + amapLocation.getErrorCode() + ", errInfo:" + amapLocation.getErrorInfo()); } } } 停止定位: mlocationClient.stopLocation();//停止定位 銷毀定位客戶端: mlocationClient. onDestroy();//銷毀定位客戶端 4、實(shí)現(xiàn)"定位小藍(lán)點(diǎn)"
下面介紹結(jié)合高德地圖 Android SDK,介紹如何顯示定位小藍(lán)點(diǎn)(詳細(xì)信息,請(qǐng)參考com.location.apis.demo.MyLocationActivity.java): /** * AMap地圖中簡(jiǎn)單介紹顯示定位小藍(lán)點(diǎn) */ 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對(duì)象 */ private void init() { if (aMap == null) { aMap = mapView.getMap(); setUpMap(); } } private void setUpMap() { aMap.setLocationSource(this);// 設(shè)置定位監(jiān)聽 aMap.getUiSettings().setMyLocationButtonEnabled(true);// 設(shè)置默認(rèn)定位按鈕是否顯示 aMap.setMyLocationEnabled(true);// 設(shè)置為true表示顯示定位層并可觸發(fā)定位,false表示隱藏定位層并不可觸發(fā)定位,默認(rèn)是false // 設(shè)置定位的類型為定位模式:定位(AMap.LOCATION_TYPE_LOCATE)、跟隨(AMap.LOCATION_TYPE_MAP_FOLLOW) // 地圖根據(jù)面向方向旋轉(zhuǎn)(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(); } /** * 定位成功后回調(diào)函數(shù) */ @Override public void onLocationChanged(AMapLocation amapLocation) { if (mListener != null && amapLocation != null) { if (amapLocation.getAMapException().getErrorCode() == 0) { mListener.onLocationChanged(amapLocation);// 顯示系統(tǒng)小藍(lán)點(diǎn) } } } /** * 激活定位 */ @Override public void activate(OnLocationChangedListener listener) { mListener = listener; if (mAMapLocationManager == null) { mAMapLocationManager = LocationManagerProxy.getInstance(this); //此方法為每隔固定時(shí)間會(huì)發(fā)起一次定位請(qǐng)求,為了減少電量消耗或網(wǎng)絡(luò)流量消耗, //注意設(shè)置合適的定位時(shí)間的間隔,并且在合適時(shí)間調(diào)用removeUpdates()方法來取消定位請(qǐng)求 //在定位結(jié)束后,在合適的生命周期調(diào)用destroy()方法 //其中如果間隔時(shí)間為-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; } } 其他注意事項(xiàng)目前手機(jī)設(shè)備在長(zhǎng)時(shí)間黑屏或鎖屏?xí)r CPU 會(huì)休眠,這導(dǎo)致定位 SDK 不能正常進(jìn)行位置更新。若您有鎖屏狀態(tài)下獲取位置的需求,您可以應(yīng) 用 alarmManager 實(shí)現(xiàn) 1 個(gè)可叫醒 CPU 的 Timer,定時(shí)請(qǐng)求定位。 使用定位 SDK 務(wù)必要注冊(cè) GPS 和網(wǎng)絡(luò)的使用權(quán)限。 在使用定位 SDK 時(shí),請(qǐng)盡量保證網(wǎng)絡(luò)暢通,如獲取網(wǎng)絡(luò)定位,地址信息等都需要設(shè)備可以正常接入網(wǎng)絡(luò)。 定位 SDK 在國(guó)內(nèi)返回 gcj02 類型坐標(biāo),海外定位將返回原始坐標(biāo)。 因?yàn)閮H設(shè)備定位(通過 GPS 定位)是設(shè)備本地定位行為,是不返回地址信息的。 |
|
|