Android 百度地圖開發（一）--- 申請API Key和在項目中顯示百度地圖

最近本身想研究下地圖，原本想研究google Map，可是申請API key比較坑爹，因而從百度地圖入手，其實他們的用法都差很少，本篇文章就帶領你們在本身的Android項目中加入百度地圖的功能，接下來我會寫一系列關於百度地圖的文章，歡迎你們到時候關注！

一 申請API key

• 在使用百度地圖以前，咱們必須去申請一個百度地圖的API key，申請地址http://lbsyun.baidu.com/apiconsole/key，本身自行註冊一個百度帳號，很快就能申請到的，以下圖

• 點擊"建立密鑰"，系統將爲咱們自動生成密鑰，固然咱們在使用密鑰以前還必須配置，點擊"設置"以下圖

Key type 選擇「for mobile」,安全碼是Android簽名證書的證書指紋 (SHA1)值 + 「;」 + 你的應用程序包名，因此當你配置好了API key 你不能隨意更換應用程序的包名， 若是更換了包名咱們須要從新配置API key,接下來咱們來介紹怎麼獲取數字簽名

咱們知道咱們開發的Android程序是須要給他簽名的，若是沒有簽名是不容許被安裝到手機或者模擬器的，那麼你會有疑問，我日常開發的應用確實沒簽名，怎麼能在模擬器或者手機上直接運行呢，其實ADT會自動的使用debug密鑰爲應用程序簽名，固然你也能夠本身建立一個屬於你本身的密鑰，直接用Eclipse可視化建立就好了，很方便的，這裏我就不介紹了

• 這裏咱們用debug.keystore來生成Android簽名證書的證書指紋 (SHA1)值，能夠在eclipse中直接查看：winows -> preferance -> android -> build。 以下圖示：

而後咱們使用keytool工具來獲取簽名證書的sha1值，在DOS輸入keytool -list -keystore C:\Users\bds\.android\debug.keystore紅色部分爲debug.keystore的路徑，接下來會要你輸入輸入密鑰庫口令，默認輸入「android」,這樣子咱們就能獲取證書指紋 (SHA1)，以下圖

紅色框框裏面的東西就是咱們須要的Android簽名證書的證書指紋 (SHA1)值，而後咱們複製出來，輸入到API key的安全碼輸入框裏面，再用分號隔開加上你的應用程序包名，如  02:5C:80:25:B2:8F:6F:60:54:B9:F4:B2:EF:94:FF:EE:CC:3C:5A:29;com.example.baidumapdemo 這樣子咱們就配置好了API key

2、下載百度地圖API庫

要在Android應用中使用百度地圖API，就須要在工程中引用百度地圖API開發包，下載地址http://developer.baidu.com/map/sdkandev-download.htm，下載Android SDKv2.1.3 lib庫就好了

3、在Android項目中引用百度地圖

• 新建Android項目 BaiduMapDemo,而後將百度地圖API庫加入工程，以下圖

• 在佈局文件中添加百度地圖控件，

[html] view plain copy print ?

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:layout_width="fill_parent"  
4.     android:layout_height="fill_parent"  
5.     android:orientation="vertical" >  
6.   
7.     <com.baidu.mapapi.map.MapView  
8.         android:id="@+id/bmapView"  
9.         android:layout_width="fill_parent"  
10.         android:layout_height="fill_parent"  
11.         android:clickable="true" />  
12.   
13. </LinearLayout>  

<?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>

• Activity界面代碼，註釋的很詳細，相信你看得懂

[java] view plain copy print ?

1. package com.example.baidumapdemo;  
2.   
3. import android.app.Activity;  
4. import android.graphics.Bitmap;  
5. import android.os.Bundle;  
6. import android.widget.Toast;  
7.   
8. import com.baidu.mapapi.BMapManager;  
9. import com.baidu.mapapi.MKGeneralListener;  
10. import com.baidu.mapapi.map.MKEvent;  
11. import com.baidu.mapapi.map.MKMapViewListener;  
12. import com.baidu.mapapi.map.MapController;  
13. import com.baidu.mapapi.map.MapPoi;  
14. import com.baidu.mapapi.map.MapView;  
15. import com.baidu.platform.comapi.basestruct.GeoPoint;  
16.   
17. public class MainActivity extends Activity {  
18.     private Toast mToast;  
19.     private BMapManager mBMapManager;  
20.     /** 
21.      * MapView 是地圖主控件 
22.      */  
23.     private MapView mMapView = null;  
24.     /** 
25.      * 用MapController完成地圖控制 
26.      */  
27.     private MapController mMapController = null;  
28.     /** 
29.      * MKMapViewListener 用於處理地圖事件回調 
30.      */  
31.     MKMapViewListener mMapListener = null;  
32.   
33.     @Override  
34.     protected void onCreate(Bundle savedInstanceState) {  
35.         super.onCreate(savedInstanceState);  
36.         /** 
37.          * 使用地圖sdk前需先初始化BMapManager，這個必須在setContentView()先初始化 
38.          */  
39.         mBMapManager = new BMapManager(this);  
40.           
41.         //第一個參數是API key,   
42.         //第二個參數是經常使用事件監聽，用來處理一般的網絡錯誤，受權驗證錯誤等，你也能夠不添加這個回調接口   
43.         mBMapManager.init("7ae13368159d6a513eaa7a17b9413b4b", new MKGeneralListener() {  
44.               
45.             //受權錯誤的時候調用的回調函數   
46.             @Override  
47.             public void onGetPermissionState(int iError) {  
48.                 if (iError ==  MKEvent.ERROR_PERMISSION_DENIED) {  
49.                     showToast("API KEY錯誤, 請檢查！");  
50.                 }  
51.             }  
52.               
53.             //一些網絡狀態的錯誤處理回調函數   
54.             @Override  
55.             public void onGetNetworkState(int iError) {  
56.                 if (iError == MKEvent.ERROR_NETWORK_CONNECT) {  
57.                     Toast.makeText(getApplication(), "您的網絡出錯啦！", Toast.LENGTH_LONG).show();  
58.                 }  
59.             }  
60.         });  
61.           
62.           
63.         setContentView(R.layout.activity_main);  
64.           
65.         mMapView = (MapView) findViewById(R.id.bmapView);  
66.           
67.           /** 
68.          * 獲取地圖控制器 
69.          */  
70.         mMapController = mMapView.getController();  
71.         /** 
72.          *  設置地圖是否響應點擊事件  . 
73.          */  
74.         mMapController.enableClick(true);  
75.         /** 
76.          * 設置地圖縮放級別 
77.          */  
78.         mMapController.setZoom(12);  
79.           
80.         /** 
81.          * 顯示內置縮放控件 
82.          */  
83.         mMapView.setBuiltInZoomControls(true);  
84.           
85.         /** 
86.          * 保存精度和緯度的類, 
87.          */  
88.         GeoPoint p = new GeoPoint((int)(22.547923 * 1E6), (int)(114.067368 * 1E6));  
89.         //設置p地方爲中心點   
90.         mMapController.setCenter(p);  
91.         mMapView.regMapViewListener(mBMapManager, new MKMapViewListener() {  
92.               
93.             /** 
94.              * 地圖移動完成時會回調此接口 方法 
95.              */  
96.             @Override  
97.             public void onMapMoveFinish() {  
98.                 showToast("地圖移動完畢！");  
99.             }  
100.               
101.             /** 
102.              * 地圖加載完畢回調此接口方法 
103.              */  
104.             @Override  
105.             public void onMapLoadFinish() {  
106.                 showToast("地圖載入完畢！");  
107.             }  
108.               
109.             /** 
110.              *  地圖完成帶動畫的操做（如: animationTo()）後，此回調被觸發 
111.              */  
112.             @Override  
113.             public void onMapAnimationFinish() {  
114.                   
115.             }  
116.               
117.             /** 
118.              *  當調用過 mMapView.getCurrentMap()後，此回調會被觸發 
119.              *  可在此保存截圖至存儲設備 
120.              */  
121.             @Override  
122.             public void onGetCurrentMap(Bitmap arg0) {  
123.                   
124.             }  
125.               
126.             /** 
127.              * 點擊地圖上被標記的點回調此方法 
128.              *  
129.              */  
130.             @Override  
131.             public void onClickMapPoi(MapPoi arg0) {  
132.                 if (arg0 != null){  
133.                     showToast(arg0.strText);  
134.                 }  
135.             }  
136.         });  
137.     }  
138.   
139.   
140.       
141.     @Override  
142.     protected void onResume() {  
143.         //MapView的生命週期與Activity同步，當activity掛起時需調用MapView.onPause()   
144.         mMapView.onResume();  
145.         super.onResume();  
146.     }  
147.   
148.   
149.   
150.     @Override  
151.     protected void onPause() {  
152.         //MapView的生命週期與Activity同步，當activity掛起時需調用MapView.onPause()   
153.         mMapView.onPause();  
154.         super.onPause();  
155.     }  
156.   
157.     @Override  
158.     protected void onDestroy() {  
159.         //MapView的生命週期與Activity同步，當activity銷燬時需調用MapView.destroy()   
160.         mMapView.destroy();  
161.           
162.         //退出應用調用BMapManager的destroy()方法   
163.         if(mBMapManager != null){  
164.             mBMapManager.destroy();  
165.             mBMapManager = null;  
166.         }  
167.           
168.         super.onDestroy();  
169.     }  
170.   
171.       
172.       
173.      /**  
174.      * 顯示Toast消息  
175.      * @param msg  
176.      */    
177.     private void showToast(String msg){    
178.         if(mToast == null){    
179.             mToast = Toast.makeText(this, msg, Toast.LENGTH_SHORT);    
180.         }else{    
181.             mToast.setText(msg);    
182.             mToast.setDuration(Toast.LENGTH_SHORT);  
183.         }    
184.         mToast.show();    
185.     }   
186.       
187.       
188. }  

package com.example.baidumapdemo;

import android.app.Activity;
import android.graphics.Bitmap;
import android.os.Bundle;
import android.widget.Toast;

import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.MKGeneralListener;
import com.baidu.mapapi.map.MKEvent;
import com.baidu.mapapi.map.MKMapViewListener;
import com.baidu.mapapi.map.MapController;
import com.baidu.mapapi.map.MapPoi;
import com.baidu.mapapi.map.MapView;
import com.baidu.platform.comapi.basestruct.GeoPoint;

public class MainActivity extends Activity {
	private Toast mToast;
	private BMapManager mBMapManager;
	/**
	 * MapView 是地圖主控件
	 */
	private MapView mMapView = null;
	/**
	 * 用MapController完成地圖控制
	 */
	private MapController mMapController = null;
	/**
	 * MKMapViewListener 用於處理地圖事件回調
	 */
	MKMapViewListener mMapListener = null;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		/**
		 * 使用地圖sdk前需先初始化BMapManager，這個必須在setContentView()先初始化
		 */
		mBMapManager = new BMapManager(this);
		
		//第一個參數是API key,
		//第二個參數是經常使用事件監聽，用來處理一般的網絡錯誤，受權驗證錯誤等，你也能夠不添加這個回調接口
		mBMapManager.init("7ae13368159d6a513eaa7a17b9413b4b", new MKGeneralListener() {
			
			//受權錯誤的時候調用的回調函數
			@Override
			public void onGetPermissionState(int iError) {
				if (iError ==  MKEvent.ERROR_PERMISSION_DENIED) {
					showToast("API KEY錯誤, 請檢查！");
	            }
			}
			
			//一些網絡狀態的錯誤處理回調函數
			@Override
			public void onGetNetworkState(int iError) {
				if (iError == MKEvent.ERROR_NETWORK_CONNECT) {
					Toast.makeText(getApplication(), "您的網絡出錯啦！", Toast.LENGTH_LONG).show();
	            }
			}
		});
		
		
		setContentView(R.layout.activity_main);
		
		mMapView = (MapView) findViewById(R.id.bmapView);
		
		  /**
         * 獲取地圖控制器
         */
        mMapController = mMapView.getController();
        /**
         *  設置地圖是否響應點擊事件  .
         */
        mMapController.enableClick(true);
        /**
         * 設置地圖縮放級別
         */
        mMapController.setZoom(12);
        
        /**
         * 顯示內置縮放控件
         */
        mMapView.setBuiltInZoomControls(true);
        
        /**
         * 保存精度和緯度的類,
         */
        GeoPoint p = new GeoPoint((int)(22.547923 * 1E6), (int)(114.067368 * 1E6));
        //設置p地方爲中心點
        mMapController.setCenter(p);
        mMapView.regMapViewListener(mBMapManager, new MKMapViewListener() {
			
        	/**
        	 * 地圖移動完成時會回調此接口 方法
        	 */
			@Override
			public void onMapMoveFinish() {
				showToast("地圖移動完畢！");
			}
			
			/**
			 * 地圖加載完畢回調此接口方法
			 */
			@Override
			public void onMapLoadFinish() {
				showToast("地圖載入完畢！");
			}
			
			/**
			 *  地圖完成帶動畫的操做（如: animationTo()）後，此回調被觸發
			 */
			@Override
			public void onMapAnimationFinish() {
				
			}
			
			/**
			 *  當調用過 mMapView.getCurrentMap()後，此回調會被觸發
			 *  可在此保存截圖至存儲設備
			 */
			@Override
			public void onGetCurrentMap(Bitmap arg0) {
				
			}
			
			/**
			 * 點擊地圖上被標記的點回調此方法
			 * 
			 */
			@Override
			public void onClickMapPoi(MapPoi arg0) {
				if (arg0 != null){
					showToast(arg0.strText);
				}
			}
		});
	}


	
	@Override
	protected void onResume() {
    	//MapView的生命週期與Activity同步，當activity掛起時需調用MapView.onPause()
		mMapView.onResume();
		super.onResume();
	}



	@Override
	protected void onPause() {
		//MapView的生命週期與Activity同步，當activity掛起時需調用MapView.onPause()
		mMapView.onPause();
		super.onPause();
	}

	@Override
	protected void onDestroy() {
		//MapView的生命週期與Activity同步，當activity銷燬時需調用MapView.destroy()
		mMapView.destroy();
		
		//退出應用調用BMapManager的destroy()方法
		if(mBMapManager != null){
			mBMapManager.destroy();
			mBMapManager = null;
		}
		
		super.onDestroy();
	}

	
	
	 /** 
     * 顯示Toast消息 
     * @param msg 
     */  
    private void showToast(String msg){  
        if(mToast == null){  
            mToast = Toast.makeText(this, msg, Toast.LENGTH_SHORT);  
        }else{  
            mToast.setText(msg);  
            mToast.setDuration(Toast.LENGTH_SHORT);
        }  
        mToast.show();  
    } 
	
	
}

1. BMapManager是地圖的引擎類，這個必須在setContentView方法以前被實例化，咱們須要使用其方法init(String strKey,MKGeneralListener listener)來加入API key， MKGeneralListener  該接口返回網絡狀態，受權驗證等結果，咱們須要實現該接口以處理相應事件
2. MapView就是咱們的地圖控件了，MapView有和Activity同步的生命週期，例如onResume() ，onPause() ，onRestoreInstanceState(Bundle state) ，destroy()等，咱們能夠經過getController()方法獲取地圖控制器MapController，這個對象可用於控制和驅動平移和縮放等
3. MapView有兩個接口能夠註冊，分別是MKMapTouchListener（地圖點擊事件監聽器），MKMapViewListener（地圖監聽器）上面的Demo我給MapView註冊了MKMapViewListener，也簡單實現了裏面的幾個方法，接下來我會帶着你們詳細的瞭解這裏面的方法，但願你們到時候關注個人博客

• 固然，咱們在程序運行以前，還必須加入相對應的權限

[html] view plain copy print ?

1. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />    
2.   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />    
3.   <uses-permission android:name="android.permission.INTERNET" />    
4.   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />    
5.   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />    
6.   <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />    
7.   <uses-permission android:name="android.permission.READ_PHONE_STATE" />  

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />  
    <uses-permission android:name="android.permission.INTERNET" />  
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />  
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />  
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />

• 運行結果

好了，今天的講解到此結束，有疑問的朋友請在下面留言。以後會持續介紹百度地圖的使用，歡迎你們關注