Android百度地图API开发.doc

最近自己想研究下地图，本来想研究google Map，但是申请API key比较坑爹，于是从百度地图入手，其实他们的用法都差不多，本篇文章就带领大家在自己的Android项目中加入百度地图的功能，接下来我会写一系列关于百度地图的文章，欢迎大家到时候关注！一 申请API key 在使用百度地图之前，我们必须去申请一个百度地图的API key，申请地址/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 -keystoreC:Usersbds.androiddebug.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，就需要在工程中引用百度地图API开发包，下载地址/map/sdkandev-download.htm，下载Android SDKv2.1.3 lib库就行了三、在Android项目中引用百度地图 新建Android项目BaiduMapDemo,然后将百度地图API库加入工程，如下图 在布局文件中添加百度地图控件，htmlview plaincopy1. 2. 6. 7. 12. 13. Activity界面代码，注释的很详细，相信你看得懂javaview plaincopy1. packagecom.example.baidumapdemo;2. 3. importandroid.app.Activity;4. importandroid.graphics.Bitmap;5. importandroid.os.Bundle;6. importandroid.widget.Toast;7. 8. importcom.baidu.mapapi.BMapManager;9. importcom.baidu.mapapi.MKGeneralListener;10. importcom.baidu.mapapi.map.MKEvent;11. importcom.baidu.mapapi.map.MKMapViewListener;12. importcom.baidu.mapapi.map.MapController;13. importcom.baidu.mapapi.map.MapPoi;14. importcom.baidu.mapapi.map.MapView;15. api.basestruct.GeoPoint;16. 17. publicclassMainActivityextendsActivity18. privateToastmToast;19. privateBMapManagermBMapManager;20. /*21. *MapView是地图主控件22. */23. privateMapViewmMapView=null;24. /*25. *用MapController完成地图控制26. */27. privateMapControllermMapController=null;28. /*29. *MKMapViewListener用于处理地图事件回调30. */31. MKMapViewListenermMapListener=null;32. 33. Override34. protectedvoidonCreate(BundlesavedInstanceState)35. super.onCreate(savedInstanceState);36. /*37. *使用地图sdk前需先初始化BMapManager，这个必须在setContentView()先初始化38. */39. mBMapManager=newBMapManager(this);40. 41. /第一个参数是APIkey,42. /第二个参数是常用事件监听，用来处理通常的网络错误，授权验证错误等，你也可以不添加这个回调接口43. mBMapManager.init(7ae13368159d6a513eaa7a17b9413b4b,newMKGeneralListener()44. 45. /授权错误的时候调用的回调函数46. Override47. publicvoidonGetPermissionState(intiError)48. if(iError=MKEvent.ERROR_PERMISSION_DENIED)49. showToast(APIKEY错误,请检查！);50. 51. 52. 53. /一些网络状态的错误处理回调函数54. Override55. publicvoidonGetNetworkState(intiError)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. GeoPointp=newGeoPoint(int)(22.547923*1E6),(int)(114.067368*1E6);89. /设置p地方为中心点90. mMapController.setCenter(p);91. mMapView.regMapViewListener(mBMapManager,newMKMapViewListener()92. 93. /*94. *地图移动完成时会回调此接口方法95. */96. Override97. publicvoidonMapMoveFinish()98. showToast(地图移动完毕！);99. 100. 101. /*102. *地图加载完毕回调此接口方法103. */104. Override105. publicvoidonMapLoadFinish()106. showToast(地图载入完毕！);107. 108. 109. /*110. *地图完成带动画的操作（如:animationTo()）后，此回调被触发111. */112. Override113. publicvoidonMapAnimationFinish()114. 115. 116. 117. /*118. *当调用过mMapView.getCurrentMap()后，此回调会被触发119. *可在此保存截图至存储设备120. */121. Override122. publicvoidonGetCurrentMap(Bitmaparg0)123. 124. 125. 126. /*127. *点击地图上被标记的点回调此方法128. *129. */130. Override131. publicvoidonClickMapPoi(MapPoiarg0)132. if(arg0!=null)133. showToast(arg0.strText);134. 135. 136. );137. 138. 139. 140. 141. Override142. protectedvoidonResume()143. /MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause()144. mMapView.onResume();145. super.onResume();146. 147. 148. 149. 150. Override151. protectedvoidonPause()152. /MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause()153. mMapView.onPause();154. super.onPause();155. 156. 157. Override158. protectedvoidonDestroy()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. *parammsg176. */177. privatevoidshowToast(Stringmsg)178. if(mToast=null)179. mToast=Toast.makeText(this,msg,Toast.LENGTH_SHORT);180. else181. mToast.setText(msg);182. mToast.setDuration(Toast.LENGTH_SHORT);183. 184. mToast.show();185. 186. 187. 188. 1. BMapManager是地图的引擎类，这个必须在setContentView方法之前被实例化，我们需要使用其方法init(String strKey,MKGeneralListener listener)来加入API key， MKGeneralListener 该接口返回网络状态，授权验证等结果，我们需要实现该接口以处理相应事件2. MapView就是我们的地图控件了，MapView有和Activity同步的生命周期，例如onResume() ，onPause() ，onRestoreInstanceState(Bundle state) ，destroy()等，我们可以通过getController()方法获取地图控制器MapContro