入門新手,記於此以爲筆記。代碼幾乎與百度示例一致,僅增加了一個地圖縮放處理,並說明了isStarted的null檢查問題。定位效果圖如下:
使用 baidumapapi_v3_0_0.jar 和 locSDK_4.1.jar 進行地圖定位。佈局比較簡單,直接使用了一個百度地圖的MapView組件,佈局文件如下:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical" >
<com.baidu.mapapi.map.MapView
android:id="@+id/bmapView"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:clickable="true" />
</LinearLayout>
使用百度定位和百度地圖都需要一些權限,其中有些是重複的,分別列出如下:
百度定位所需權限:
<!-- 這個權限用於進行網絡定位 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 這個權限用於訪問GPS定位 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 用於訪問wifi網絡信息,wifi信息會用於進行網絡定位 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 獲取運營商信息,用於支持提供運營商信息相關的接口 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 這個權限用於獲取wifi的獲取權限,wifi信息會用來進行網絡定位 -->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<!-- 用於讀取手機當前的狀態 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 寫入擴展存儲,向擴展卡寫入數據,用於寫入離線定位數據 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 訪問網絡,網絡定位需要上網 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- SD卡讀取權限,用戶寫入離線定位數據 -->
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
<!-- 允許應用讀取低級別的系統日誌文件 -->
<uses-permission android:name="android.permission.READ_LOGS" />
使用百度地圖所需權限:
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission android:name="android.permission.USE_CREDENTIALS" />
<uses-permission android:name="android.permission.MANAGE_ACCOUNTS" />
<uses-permission android:name="android.permission.AUTHENTICATE_ACCOUNTS" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.BROADCAST_STICKY" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
新版本的百度地圖使用時還需要一個KEY密鑰,這可以免費申請,然後需要在 AndroidManifest.xml文件中的Application標籤中加入Key配置:
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="你申請的Key密鑰" />
對應定位來說,還需要在Application標籤中配置一個service屬性:
<service
android:name="com.baidu.location.f"
android:enabled="true"
android:process=":remote" />
在使用SDK的各組件之前需調用SDKInitializer類的靜態初始化函數進行全局初始化,這裏在OnCreate的setContentView之前調用,因爲佈局中用到了MapView組件。
MapView組件有三個控制函數:onDestroy()、onPause()、onResume() 用於使銷燬、暫停和喚醒百度地圖,需要在Activity的相應的函數中調用它們,以更好地管理地圖的生命週期。
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//在使用SDK各組件之前初始化context信息,傳入ApplicationContext
//注意該方法要再setContentView方法之前實現
SDKInitializer.initialize(getApplicationContext());
setContentView(R.layout.activity_main);
}
@Override
protected void onDestroy() {
super.onDestroy();
<span style="white-space:pre"> </span>// 如果開啓了定位層的顯示,則在銷燬前關閉它
<span style="white-space:pre"> mBaiduMap.setMyLocationEnabled(false); </span>
// 在activity執行onDestroy時執行mMapView.onDestroy(),實現地圖生命週期管理
mMapView.onDestroy();
}
@Override
protected void onResume() {
super.onResume();
// 在activity執行onResume時執行mMapView. onResume (),實現地圖生命週期管理
mMapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
// 在activity執行onPause時執行mMapView. onPause (),實現地圖生命週期管理
mMapView.onPause();
}
在定位顯示時,需要開啓地圖的定位圖層,可通過地圖控制器的 setMyLocationEnabled 方法來設置,地圖的控制器對象BaiduMap 可由 MapView 的 getMap() 方法獲取。需注意的是,在上面的 onDestroy()方法中,進行了定位層關閉的設置,否則,在後面的實時顯示定位信息的showLocation函數中的 BaiduMap對象的 setMyLocationData方法調用會出現錯誤。
進行定位需要一個 LocationClient 對象,然後用該對象的 registerLocationListener 方法註冊一個監聽器、設置定位選項,並開啓定位。
// 獲取地圖組件引用及地圖控制器
mMapView = (MapView) findViewById(R.id.bmapView);
mBaiduMap = mMapView.getMap();
// 開啓定位圖層
mBaiduMap.setMyLocationEnabled(true);
mLocationClient = new LocationClient(getApplicationContext()); // 聲明LocationClient類
mLocationClient.registerLocationListener(myListener); // 註冊監聽器
// 設置定位選項
LocationClientOption option = new LocationClientOption();
// option.disableCache(true); // 是否允許緩存
option.setLocationMode(LocationMode.Hight_Accuracy);// 設置定位模式
option.setOpenGps(true); // 開啓GPS
option.setCoorType("bd09ll");// 返回的定位結果是百度經緯度,默認值gcj02
option.setScanSpan(2000);// 設置發起定位請求的間隔時間爲2000ms
option.setIsNeedAddress(true);// 返回的定位結果包含地址信息
option.setNeedDeviceDirect(true);// 返回的定位結果包含手機機頭的方向
mLocationClient.setLocOption(option);
mLocationClient.start(); // 啓動定位
其中 myListener 的聲明爲:
BDLocationListener myListener = new MyLocationListener();
MyLocationListener 是一個實現了 BDLocationListener 接口的自定義類,當經緯度改變時,它能接收到新的位置信息,經處理後便可在地圖上顯示其位置:
public class MyLocationListener implements BDLocationListener {
@Override
public void onReceiveLocation(BDLocation location) {
if (location == null)
return;
showLocation(location);
}
public void onReceivePoi(BDLocation poiLocation) {
// 將在下個版本中去除poi功能
if (poiLocation == null) {
return;
}
}
}
在showLocation 函數中進行數據數據處理,然後在地圖中標出當前位置:
public void showLocation(BDLocation location) {
// 構造定位數據
MyLocationData locData = new MyLocationData.Builder()
.accuracy(location.getRadius())
// 此處設置開發者獲取到的方向信息,順時針0-360
.direction(location.getDirection()).latitude(location.getLatitude())
.longitude(location.getLongitude()).build();
// 設置定位數據
mBaiduMap.setMyLocationData(locData);
// 縮放設置
if (isFirstLoc) {
isFirstLoc = false;
// 設置地圖縮放比例:17級100米
MapStatusUpdate ms = MapStatusUpdateFactory.zoomTo(17);
mBaiduMap.setMapStatus(ms);
}
// 更新地圖位置
LatLng ll = new LatLng(location.getLatitude(),
location.getLongitude());
MapStatusUpdate u = MapStatusUpdateFactory.newLatLng(ll);
mBaiduMap.animateMapStatus(u);
}
僅在第一次定位後設置地圖的顯示比例,將其放大到100米級別。最後的“更新地圖位置”部分放到了if 條件之外,這樣在每次定位後或在地圖移到其它地方後,都會將新的定位後的位置顯示在屏幕中。
實際上定位層的顯示有一個相應的模式,默認的模式爲 NORMAL,這種模式下地圖不會根據定位信息進行更新,因此在本例中使用了手動更新方式,即取得經緯度後用animateMapStatus 方法來改變地圖的狀態,以達到實時更新定位層的目的。在(二)中將說明定位層的顯示方式。
在百度定位開發的介紹示例中有一個定位端啓動的判斷:
mLocationClient.setLocOption(option);
mLocationClient.start();
if (mLocationClient != null && mLocationClient.isStarted())
mLocationClient.requestLocation();
else
Log.d("LocSDK4", "locationClient is null or not started");
這僅是在啓動後手動地調用一個定位請求,但這是可省略的。實際上 isStarted函數的返回幾乎都爲 null ,但這並不影響後續的定位,因爲啓動需要時間,而此處的檢查顯然是太緊急了的。根據論壇裏說是因爲這些示例更新尚未完善,因此不必糾結於此處的 null 問題。
另外,所聲明的變量有:
MapView mMapView = null;
BaiduMap mBaiduMap = null;
public LocationClient mLocationClient = null;
public BDLocationListener myListener = new MyLocationListener();
Boolean isFirstLoc = true;
記錄完畢。