百度地圖3.0初用筆記(一)


  入門新手,記於此以爲筆記。代碼幾乎與百度示例一致,僅增加了一個地圖縮放處理,並說明了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;

  記錄完畢。











發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章