Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图

2022-11-15 14:44:32

 
Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图 分类：
Android 百度地图开发（2） Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图
 

最近自己想研究下地图，本来想研究google Map，但是申请API key比较坑爹，于是从百度地图入手，其实他们的用法都差不多，本篇文章就带领大家在自己的Android项目中加入百度地图的功能，接下来我会写一系列关于百度地图的文章，欢迎大家到时候关注！

 

一 申请API key

  • 在使用百度地图之前，我们必须去申请一个百度地图的API key，申请地址http://lbsyun.baidu.com/apiconsole/key，自己自行注册一个百度账号，很快就能申请到的，如下图

Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图

  • 点击"创建密钥"，系统将为我们自动生成密钥，当然我们在使用密钥之前还必须配置，点击"设置"如下图

Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图

Key type 选择“for mobile”,安全码是Android签名证书的证书指纹 (SHA1)值 + “;” + 你的应用程序包名，所以当你配置好了API key 你不能随意更换应用程序的包名， 如果更换了包名我们需要重新配置API key,接下来我们来介绍怎么获取数字签名

我们知道我们开发的Android程序是需要给他签名的，如果没有签名是不允许被安装到手机或者模拟器的，那么你会有疑问，我平常开发的应用确实没签名，怎么能在模拟器或者手机上直接运行呢，其实ADT会自动的使用debug密钥为应用程序签名，当然你也可以自己创建一个属于你自己的密钥，直接用Eclipse可视化创建就行了，很方便的，这里我就不介绍了

  • 这里我们用debug.keystore来生成Android签名证书的证书指纹 (SHA1)值，可以在eclipse中直接查看：winows -> preferance -> android -> build。 如下图示：

Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图

然后我们使用keytool工具来获取签名证书的sha1值，在DOS输入keytool -list -keystore C:\Users\bds\.android\debug.keystore红色部分为debug.keystore的路径，接下来会要你输入输入密钥库口令，默认输入“android”,这样子我们就能获取证书指纹 (SHA1)，如下图

Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图

红色框框里面的东西就是我们需要的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开发包，下载地址http://developer.baidu.com/map/sdkandev-download.htm，下载Android SDKv2.1.3 lib库就行了

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

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

Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图

  • 在布局文件中添加百度地图控件，
  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. <com.baidu.mapapi.map.MapView
  7. android:id="@+id/bmapView"
  8. android:layout_width="fill_parent"
  9. android:layout_height="fill_parent"
  10. android:clickable="true" />
  11. </LinearLayout>
  • Activity界面代码，注释的很详细，相信你看得懂
  1. package com.example.baidumapdemo;
  2. import android.app.Activity;
  3. import android.graphics.Bitmap;
  4. import android.os.Bundle;
  5. import android.widget.Toast;
  6. import com.baidu.mapapi.BMapManager;
  7. import com.baidu.mapapi.MKGeneralListener;
  8. import com.baidu.mapapi.map.MKEvent;
  9. import com.baidu.mapapi.map.MKMapViewListener;
  10. import com.baidu.mapapi.map.MapController;
  11. import com.baidu.mapapi.map.MapPoi;
  12. import com.baidu.mapapi.map.MapView;
  13. import com.baidu.platform.comapi.basestruct.GeoPoint;
  14. public class MainActivity extends Activity {
  15. private Toast mToast;
  16. private BMapManager mBMapManager;
  17. /**
  18. * MapView 是地图主控件
  19. */
  20. private MapView mMapView = null;
  21. /**
  22. * 用MapController完成地图控制
  23. */
  24. private MapController mMapController = null;
  25. /**
  26. * MKMapViewListener 用于处理地图事件回调
  27. */
  28. MKMapViewListener mMapListener = null;
  29. @Override
  30. protected void onCreate(Bundle savedInstanceState) {
  31. super.onCreate(savedInstanceState);
  32. /**
  33. * 使用地图sdk前需先初始化BMapManager，这个必须在setContentView()先初始化
  34. */
  35. mBMapManager = new BMapManager(this);
  36. //第一个参数是API key,
  37. //第二个参数是常用事件监听，用来处理通常的网络错误，授权验证错误等，你也可以不添加这个回调接口
  38. mBMapManager.init("7ae13368159d6a513eaa7a17b9413b4b", new MKGeneralListener() {
  39. //授权错误的时候调用的回调函数
  40. @Override
  41. public void onGetPermissionState(int iError) {
  42. if (iError ==  MKEvent.ERROR_PERMISSION_DENIED) {
  43. showToast("API KEY错误, 请检查！");
  44. }
  45. }
  46. //一些网络状态的错误处理回调函数
  47. @Override
  48. public void onGetNetworkState(int iError) {
  49. if (iError == MKEvent.ERROR_NETWORK_CONNECT) {
  50. Toast.makeText(getApplication(), "您的网络出错啦！", Toast.LENGTH_LONG).show();
  51. }
  52. }
  53. });
  54. setContentView(R.layout.activity_main);
  55. mMapView = (MapView) findViewById(R.id.bmapView);
  56. /**
  57. * 获取地图控制器
  58. */
  59. mMapController = mMapView.getController();
  60. /**
  61. *  设置地图是否响应点击事件  .
  62. */
  63. mMapController.enableClick(true);
  64. /**
  65. * 设置地图缩放级别
  66. */
  67. mMapController.setZoom(12);
  68. /**
  69. * 显示内置缩放控件
  70. */
  71. mMapView.setBuiltInZoomControls(true);
  72. /**
  73. * 保存精度和纬度的类,
  74. */
  75. GeoPoint p = new GeoPoint((int)(22.547923 * 1E6), (int)(114.067368 * 1E6));
  76. //设置p地方为中心点
  77. mMapController.setCenter(p);
  78. mMapView.regMapViewListener(mBMapManager, new MKMapViewListener() {
  79. /**
  80. * 地图移动完成时会回调此接口 方法
  81. */
  82. @Override
  83. public void onMapMoveFinish() {
  84. showToast("地图移动完毕！");
  85. }
  86. /**
  87. * 地图加载完毕回调此接口方法
  88. */
  89. @Override
  90. public void onMapLoadFinish() {
  91. showToast("地图载入完毕！");
  92. }
  93. /**
  94. *  地图完成带动画的操作（如: animationTo()）后，此回调被触发
  95. */
  96. @Override
  97. public void onMapAnimationFinish() {
  98. }
  99. /**
  100. *  当调用过 mMapView.getCurrentMap()后，此回调会被触发
  101. *  可在此保存截图至存储设备
  102. */
  103. @Override
  104. public void onGetCurrentMap(Bitmap arg0) {
  105. }
  106. /**
  107. * 点击地图上被标记的点回调此方法
  108. *
  109. */
  110. @Override
  111. public void onClickMapPoi(MapPoi arg0) {
  112. if (arg0 != null){
  113. showToast(arg0.strText);
  114. }
  115. }
  116. });
  117. }
  118. @Override
  119. protected void onResume() {
  120. //MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause()
  121. mMapView.onResume();
  122. super.onResume();
  123. }
  124. @Override
  125. protected void onPause() {
  126. //MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause()
  127. mMapView.onPause();
  128. super.onPause();
  129. }
  130. @Override
  131. protected void onDestroy() {
  132. //MapView的生命周期与Activity同步，当activity销毁时需调用MapView.destroy()
  133. mMapView.destroy();
  134. //退出应用调用BMapManager的destroy()方法
  135. if(mBMapManager != null){
  136. mBMapManager.destroy();
  137. mBMapManager = null;
  138. }
  139. super.onDestroy();
  140. }
  141. /**
  142. * 显示Toast消息
  143. * @param msg
  144. */
  145. private void showToast(String msg){
  146. if(mToast == null){
  147. mToast = Toast.makeText(this, msg, Toast.LENGTH_SHORT);
  148. }else{
  149. mToast.setText(msg);
  150. mToast.setDuration(Toast.LENGTH_SHORT);
  151. }
  152. mToast.show();
  153. }
  154. }
  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，也简单实现了里面的几个方法，接下来我会带着大家详细的了解这里面的方法，希望大家到时候关注我的博客
  • 当然，我们在程序运行之前，还必须加入相对应的权限
  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" />
  • 运行结果
Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图Android 百度地图开发（一）--- 申请API Key和在项目中显示百度地图

好了，今天的讲解到此结束，有疑问的朋友请在下面留言。之后会持续介绍百度地图的使用，欢迎大家关注

原文地址http://blog.csdn.net/xiaanming/article/details/11171581

上一篇：NopCommerce 3. Controller 分析


下一篇：sql相关操作