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