查看: 39747|回复: 82

Android百度地图系列教程

  [复制链接]

   

该用户从未签到

电梯直达

楼主

 
发表于 2013-4-10 10:38:20 | 只看该作者

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有帐号?注册

x

一、SDK版本v2.0.0初探

一、开发前的准备工作:

1、注册百度账号,并登录。(有百度账号的话直接登录)

2、申请Key,地址:http://developer.baidu.com/map/android-mobile-apply-key.htm

注:经研究发现在申请KEY时,应用名称一定要写成my_app_应用名(也就是说"my_app_"是必须要有的)这样,生成的API密钥后面才可
用。其他格式的也可以生成API密钥,但是在使用过程中会出问题。(比如:一开始就报授权Key错误,或者使用一段时间后就不行了)

3、下载SDK(v2.0.0),地址:http://developer.baidu.com/map/sdkandev-download.htm

注:下载Android SDKv2.0.0
(矢量地图版),里面有BaiduMap_AndroidSDK_v2.0.0_Lib.zip、
BaiduMap_AndroidSDK_v2.0.0_Docs.zip和
BaiduMap_AndroidSDK_v2.0.0_Sample.zip三个压缩包。

二、搭建开发环境,开始The world, hello(世界,你好)之旅:

1、创建android项目,在选SDK时(Choose an SDK to target),选的不是Google APIs,是不带地图服务的SDK 。

2、在项目创建完毕,在工程里新建libs文件夹,将开发包(BaiduMap_AndroidSDK_v2.0.0_Lib.zip)里的
baidumapapi_v2_0_0.jar拷贝到libs根目录下,将libBMapApiEngine_v2_0_0.so和
libvi_voslib.so 拷贝到libs\armeabi目录下,拷贝完成后的工程目录如下图所示:

3、在AndroidManifest.xml文件中添加使用权限:

  1. <!-- 使用网络功能所需权限 -->
  2. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" >
  3. </uses-permission>
  4. <uses-permission android:name="android.permission.INTERNET" >
  5. </uses-permission>
  6. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" >
  7. </uses-permission>
  8. <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" >
  9. </uses-permission>
  10. <!-- 读取手机的当前状态权限,没有的话会报错,这个是使用百度地图API必须的 -->
  11. <uses-permission android:name="android.permission.READ_PHONE_STATE" >
  12. </uses-permission>
  13. <!--Cache功能需要读写外部存储器 ,若没这个权限,地图加载不出来-->
  14. <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" >
  15. </uses-permission>

复制代码

4、添加对多种屏幕的支持:

  1. <!--
  2. 添加屏幕支持
  3. android:anyDensity="true"
  4. 这个属性指明应用程序是否包含了能够适用于任何屏幕密度的资源。
  5. 对于支持Android1.6(API Level 4)和更高版本的应用程序,这个属性的默认值是true,
  6. 并且除非绝对的确认这是应用程序正常工作所必须的,否则不应该把它设置为false。
  7. 只是在应用程序直接操作位图时才需要禁止这个属性。
  8. android:largeScreens="true"
  9. 这个属性用于指示应用程序是否支持较大外形的屏幕。
  10. 一个large类型的屏幕被定义成一个比normal类型的手持设备的屏幕明显还要大的屏幕,
  11. 并且为了让应用程序能够良好的使用,使用这个属性时要特别小心,尽管可以依赖系统来调整尺寸,
  12. 以便能够填充屏幕。
  13. 这个属性的默认值实际上在某些版本之间是不同的,因此最好在任何时候都明确的声明这个属性。
  14. 如果设置为false,系统会启用屏幕兼容模式,这时要格外的小心。
  15. android:normalScreens="true"
  16. 这个属性用于指示应用程序是否支持普通外形的屏幕。
  17. 典型的是HVGA中等密度的屏幕,但是WQVGA低密度和WVGA高密度屏幕也被认为是普通屏幕。
  18. 这个属性的默认值是true。
  19. android:smallScreens="true"
  20. 这个属性用于指定应用程序是否支持较小外形的屏幕。
  21. 一个small类型的屏幕被定义成一个比normal(传统的HVGA)类型的屏幕还要小的屏幕。
  22. 外部服务(如Google Play)不会把不支持小屏的应用程序提供给小屏设备,
  23. 因为很少有能够确保该应用程序在小屏幕的设备上正常工作的平台。这个属性的默认值是true。
  24. android:resizeable="true"
  25. 这个属性用于指示针对不同的屏幕尺寸,应用程序是否可以调整尺寸。默认值是true。
  26. -->
  27. <supports-screens
  28. android:anyDensity="true"
  29. android:largeScreens="true"
  30. android:normalScreens="true"
  31. android:resizeable="true"
  32. android:smallScreens="true" />

复制代码

5、配置Activity:

  1. <activity
  2. android:configChanges="orientation|keyboardHidden"
  3. android:label="@string/app_name"
  4. android:name=".BaiduMapBaseActivity"
  5. android:screenOrientation="sensor" >
  6. <intent-filter >
  7. <action android:name="android.intent.action.MAIN" />
  8. <category android:name="android.intent.category.LAUNCHER" />
  9. </intent-filter>
  10. </activity>

复制代码

6、在布局xml文件中添加地图控件:

  1. <com.baidu.mapapi.map.MapView
  2. android:id="@+id/bmapsView"
  3. android:layout_width="fill_parent"
  4. android:layout_height="fill_parent"
  5. android:clickable="true" />

复制代码

7、 创建地图Activity,并import相关类:

a. 创建地图引擎管理类对象,并初始化。

  1. // 注意:请在调用setContentView前初始化BMapManager对象,否则会报错
  2. mBMapManager = new BMapManager(this.getApplicationContext());
  3. mBMapManager.init(BAIDU_MAP_KEY, new MKGeneralListener() {
  4. @Override
  5. public void onGetNetworkState(int iError) {
  6. if (iError == MKEvent.ERROR_NETWORK_CONNECT) {
  7. Toast.makeText(BaiduMapBaseActivity.this.getApplicationContext(),
  8. "您的网络出错啦!", Toast.LENGTH_LONG).show();
  9. }
  10. }
  11. @Override
  12. public void onGetPermissionState(int iError) {
  13. if (iError == MKEvent.ERROR_PERMISSION_DENIED) {
  14. // 授权Key错误:
  15. Toast.makeText(BaiduMapBaseActivity.this.getApplicationContext(),
  16. "请在 DemoApplication.java文件输入正确的授权Key!", Toast.LENGTH_LONG).show();
  17. }
  18. }
  19. });

复制代码

b.通过ID获取代表地图显示组件的MapView对象,并设置启用内置的缩放控件。

  1. mMapView = (MapView) this.findViewById(R.id.bmapsView);
  2. // 设置启用内置的缩放控件
  3. mMapView.setBuiltInZoomControls(true);

复制代码

c.获取地图控制器对象,并设置地图的中心点及缩放级别。

  1. // 获取地图控制器,可以用它控制平移和缩放
  2. MapController mMapController = mMapView.getController();
  3. // 用给定的经纬度构造一个GeoPoint,单位是微度 (度 * 1E6)
  4. // 北京天安门的经纬度:39.915 * 1E6,116.404 * 1E6
  5. // GeoPoint mGeoPoint = new GeoPoint((int) (39.915 * 1E6), (int) (116.404 * 1E6));
  6. // 上海市浦东新区的GPS纬度经度值:31.224078,121.540419
  7. GeoPoint mGeoPoint = new GeoPoint(
  8. (int) (31.224078 * 1E6),
  9. (int) (121.540419 * 1E6));
  10. // 设置地图的中心点
  11. mMapController.setCenter(mGeoPoint);
  12. // 设置地图的缩放级别。 这个值的取值范围是[3,18]。
  13. mMapController.setZoom(13);

复制代码

d.重写Activity的生命周期回调方法onResume()、onPause()和onDestroy(),管理地图引擎管理类对象和显示对象生命周期。

  1. @Override
  2. protected void onResume() {
  3. mMapView.onResume();
  4. if (mBMapManager != null) {
  5. mBMapManager.start();
  6. }
  7. super.onResume();
  8. }
  9. @Override
  10. protected void onPause() {
  11. mMapView.onPause();
  12. if (mBMapManager != null) {
  13. mBMapManager.stop();
  14. }
  15. super.onPause();
  16. }
  17. @Override
  18. protected void onDestroy() {
  19. mMapView.destroy();
  20. if (mBMapManager != null) {
  21. mBMapManager.destroy();
  22. mBMapManager = null;
  23. }
  24. super.onDestroy();
  25. }

复制代码

经过以上这些步骤,加载的是上海市浦东新区地图(基础图),运行工程效果图如下:

注:基本的地图图层,包括若干个缩放级别,显示基本的地图信息,包括道路、街道、学校、公园等内容。

e.在地图中显示实时交通信息示图(当前,全国范围内已支持多个城市实时路况查询,且会陆续开通其他城市。)

  1. // 在地图中显示实时交通信息示
  2. mMapView.setTraffic(true);

复制代码

运行效果图如下:

f.显示卫星图(卫星地图是卫星拍摄的真实的地理面貌,所以卫星地图可用来检测地面的信息,你可以了解到地理位置,地形等。)

  1. // 显示卫星图
  2. mMapView.setSatellite(true);

复制代码

运行效果图如下:

完整代码如下:

  1. package com.android.baidu.map;
  2. import android.app.Activity;
  3. import android.os.Bundle;
  4. import android.widget.Toast;
  5. import com.baidu.mapapi.BMapManager;
  6. import com.baidu.mapapi.MKGeneralListener;
  7. import com.baidu.mapapi.map.MKEvent;
  8. import com.baidu.mapapi.map.MapController;
  9. import com.baidu.mapapi.map.MapView;
  10. import com.baidu.platform.comapi.basestruct.GeoPoint;
  11. /**
  12. * 基本的地图图层,包括若干个缩放级别,显示基本的地图信息,包括道路、街道、学校、公园等内容。
  13. * @author android_ls
  14. *
  15. */
  16. public class BaiduMapBaseActivity extends Activity {
  17. /**地图引擎管理类*/
  18. private BMapManager mBMapManager = null;
  19. /**显示地图的View*/
  20. private MapView mMapView = null;
  21. /**
  22. * 经研究发现在申请KEY时:应用名称一定要写成my_app_应用名(也就是说"my_app_"是必须要有的)。
  23. * 百度地图SDK提供的服务是免费的,接口无使用次数限制。您需先申请密钥(key),才可使用该套SDK。
  24. * */
  25. public static final String BAIDU_MAP_KEY = "07418AEC69BAAB7104C6230A6120C580DFFAEEBB";
  26. @Override
  27. public void onCreate(Bundle savedInstanceState) {
  28. super.onCreate(savedInstanceState);
  29. // 注意:请在调用setContentView前初始化BMapManager对象,否则会报错
  30. mBMapManager = new BMapManager(this.getApplicationContext());
  31. mBMapManager.init(BAIDU_MAP_KEY, new MKGeneralListener() {
  32. @Override
  33. public void onGetNetworkState(int iError) {
  34. if (iError == MKEvent.ERROR_NETWORK_CONNECT) {
  35. Toast.makeText(BaiduMapBaseActivity.this.getApplicationContext(),
  36. "您的网络出错啦!",
  37. Toast.LENGTH_LONG).show();
  38. }
  39. }
  40. @Override
  41. public void onGetPermissionState(int iError) {
  42. if (iError == MKEvent.ERROR_PERMISSION_DENIED) {
  43. // 授权Key错误:
  44. Toast.makeText(BaiduMapBaseActivity.this.getApplicationContext(),
  45. "请在 DemoApplication.java文件输入正确的授权Key!",
  46. Toast.LENGTH_LONG).show();
  47. }
  48. }
  49. });
  50. setContentView(R.layout.main);
  51. mMapView = (MapView) this.findViewById(R.id.bmapsView);
  52. // 设置启用内置的缩放控件
  53. mMapView.setBuiltInZoomControls(true);
  54. // 获取地图控制器,可以用它控制平移和缩放
  55. MapController mMapController = mMapView.getController();
  56. // 用给定的经纬度构造一个GeoPoint,单位是微度 (度 * 1E6)
  57. // 北京天安门的经纬度:39.915 * 1E6,116.404 * 1E6
  58. /* GeoPoint mGeoPoint = new GeoPoint(
  59. (int) (39.915 * 1E6),
  60. (int) (116.404 * 1E6));*/
  61. // 上海市浦东新区的GPS纬度经度值:31.224078,121.540419
  62. GeoPoint mGeoPoint = new GeoPoint(
  63. (int) (31.224078 * 1E6),
  64. (int) (121.540419 * 1E6));
  65. // 设置地图的中心点
  66. mMapController.setCenter(mGeoPoint);
  67. // 设置地图的缩放级别。 这个值的取值范围是[3,18]。
  68. mMapController.setZoom(13);
  69. // 当前,全国范围内已支持多个城市实时路况查询,且会陆续开通其他城市。
  70. // 在地图中显示实时交通信息示
  71. // mMapView.setTraffic(true);
  72. // 卫星地图是卫星拍摄的真实的地理面貌,所以卫星地图可用来检测地面的信息,你可以了解到地理位置,地形等。
  73. // 显示卫星图,屏掉 mMapView.setTraffic(true);这行代码。
  74. mMapView.setSatellite(true);
  75. }
  76. // 重写以下方法,管理API
  77. @Override
  78. protected void onResume() {
  79. mMapView.onResume();
  80. if (mBMapManager != null) {
  81. mBMapManager.start();
  82. }
  83. super.onResume();
  84. }
  85. @Override
  86. protected void onPause() {
  87. mMapView.onPause();
  88. if (mBMapManager != null) {
  89. mBMapManager.stop();
  90. }
  91. super.onPause();
  92. }
  93. @Override
  94. protected void onDestroy() {
  95. mMapView.destroy();
  96. if (mBMapManager != null) {
  97. mBMapManager.destroy();
  98. mBMapManager = null;
  99. }
  100. super.onDestroy();
  101. }
  102. }

复制代码

最新文章

  1. 【腾讯Bugly干货分享】Android Linker 与 SO 加壳技术
  2. bootstrap学习
  3. Qt中数据模块学习
  4. 搭建MySQL MHA高可用
  5. 5.6---交换整数的奇数位和偶数位(CC150)
  6. iOS开发系列--Objective-C 之 KVC、KVO
  7. paper 110:凸优化和非凸优化
  8. BendFord&#39;s law&#39;s Chi square test
  9. 在wpf中如何让MediaElement的视频循环播放
  10. hdu 4686 Arc of Dream_矩阵快速幂
  11. 学习笔记︱Nvidia DIGITS网页版深度学习框架——深度学习版SPSS
  12. WebService之CXF注解之二(Service接口)
  13. VS Code 运行 TypeScript 操作指南
  14. win10系统office2010每次打开总是出现配置进度
  15. oracle 查看临时表空间temp 的使用情况以及扩展表空间
  16. smarty 双引号中嵌入变量的方法
  17. java基础(二) 自增自减与贪心规则
  18. MySQL:关于 unauthenticated user
  19. 20165233 Java第五、六章学习总结
  20. I/O的整体介绍

热门文章

  1. C#调用PowerShell的经历
  2. Unity物理优化的一个小问题
  3. angular入门系列教程2
  4. 【BZOJ】【1070】【SCOI2007】修车
  5. [原]android不支持命名的semaphore
  6. MySQL之重设密码(忘记密码)讲解
  7. PHP之session相关实例教程与经典代码
  8. Linux操作系统下软件的安装方法大全
  9. 让32位Eclipse和64位Eclipse同时在64的Windows7上运行
  10. Oracle 6 - 锁和闩 - 并发问题和隔离级别