Android 百度地图开发（一）

在自己的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

二、下载百度地图API库

要在Android应用中使用百度地图API，就须要在project中引用百度地图API开发包，下载地址http://developer.baidu.com/map/sdkandev-download.htm，下载Android SDKv2.1.3 lib库即可了

三、在Android项目中引用百度地图

• 新建Android项目 BaiduMapDemo,然后将百度地图API库增加project，例如以下图

• 在布局文件里加入百度地图控件，

[html] view plaincopy

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>  

• Activity界面代码。凝视的非常具体，相信你看得懂

[java] view plaincopy

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. }