最近自己想研究下地图,本来想研究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。 如下图示:

签名证书的证书指纹 (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,就需要在工程中引用百度地图API开发包,下载地址​​http://developer.baidu.com/map/sdkandev-download.htm​​​,下载​​Android SDKv2.1.3 lib库​​就行了


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

  • 新建Android项目 BaiduMapDemo,然后将百度地图API库加入工程,如下图

  • 在布局文件中添加百度地图控件,



[html]  ​​view plain​​ ​​co



  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 plain​​ ​​co



  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. null;  
  32.   
  33. @Override  
  34. protected void onCreate(Bundle savedInstanceState) {  
  35. super.onCreate(savedInstanceState);  
  36. /**
  37.          * 使用地图sdk前需先初始化BMapManager,这个必须在setContentView()先初始化
  38.          */  
  39. new BMapManager(this);  
  40.           
  41. //第一个参数是API key,  
  42. //第二个参数是常用事件监听,用来处理通常的网络错误,授权验证错误等,你也可以不添加这个回调接口  
  43. "7ae13368159d6a513eaa7a17b9413b4b", new MKGeneralListener() {  
  44.               
  45. //授权错误的时候调用的回调函数  
  46. @Override  
  47. public void onGetPermissionState(int iError) {  
  48. if (iError ==  MKEvent.ERROR_PERMISSION_DENIED) {  
  49. "API KEY错误, 请检查!");  
  50.                 }  
  51.             }  
  52.               
  53. //一些网络状态的错误处理回调函数  
  54. @Override  
  55. public void onGetNetworkState(int iError) {  
  56. if (iError == MKEvent.ERROR_NETWORK_CONNECT) {  
  57. "您的网络出错啦!", 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. true);  
  75. /**
  76.          * 设置地图缩放级别
  77.          */  
  78. 12);  
  79.           
  80. /**
  81.          * 显示内置缩放控件
  82.          */  
  83. true);  
  84.           
  85. /**
  86.          * 保存精度和纬度的类,
  87.          */  
  88. new GeoPoint((int)(22.547923 * 1E6), (int)(114.067368 * 1E6));  
  89. //设置p地方为中心点  
  90.         mMapController.setCenter(p);  
  91. new MKMapViewListener() {  
  92.               
  93. /**
  94.              * 地图移动完成时会回调此接口 方法
  95.              */  
  96. @Override  
  97. public void onMapMoveFinish() {  
  98. "地图移动完毕!");  
  99.             }  
  100.               
  101. /**
  102.              * 地图加载完毕回调此接口方法
  103.              */  
  104. @Override  
  105. public void onMapLoadFinish() {  
  106. "地图载入完毕!");  
  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. 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. 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. }  




BMapManager是地图的引擎类,这个必须在setContentView方法之前被实例化,我们需要使用其方法init(String strKey,MKGeneralListener listener)来加入API key, MKGeneralListener  该接口返回网络状态,授权验证等结果,我们需要实现该接口以处理相应事件MapView就是我们的地图控件了,MapView有和Activity同步的生命周期,例如onResume() ,onPause() ,onRestoreInstanceState(Bundle state) ,destroy()等,我们可以通过getController()方法获取地图控制器MapController,这个对象可用于控制和驱动平移和缩放等MapView有两个接口可以注册,分别是MKMapTouchListener(地图点击事件监听器),MKMapViewListener(地图监听器)上面的Demo我给MapView注册了MKMapViewListener,也简单实现了里面的几个方法,接下来我会带着大家详细的了解这里面的方法,希望大家到时候关注我的博客

当然,我们在程序运行之前,还必须加入相对应的权限


[html]  ​​view plain​​ ​​co



  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" />  



  • 运行结果