导航

百度地图开发之一】申请Key和配置初览显示地图

Posted on 2014-03-15 13:13  ghostll  阅读(1084)  评论(0)  编辑  收藏  举报

在前面的话:

【百度地图开发之一】申请Key和配置初览显示地图(博客地址:http://blog.csdn.net/developer_jiangqq),转载请注明。

     Author:hmjiangqq

     Email:jiangqqlmj@163.com

  近段公司项目要实现地图定位相关的功能,而且要求指定使用百度地图,所以花点时间来学习研究一下百度地图的基本使用.今天我先和大家一起来学习申请开发Key和配置显示地图.后续文章中也会继续更新跟进百度地图一系列的文章,也请大家一起关注!

 

(一):申请开发Key

       1:在我们使用百度地图之前,首先我们需要去BaiduMapSdK官方网站中申请key(地址为:http://lbsyun.baidu.com/apiconsole/key),看到如下界面点击创建应用,填写应用名称.

          和应用类型(for mobile)

       

       

        

       2:开始配置应用,我们需要配置我们应用的安全码(形式为:输入“安全码”。安全码的组成规则为：Android签名证书的sha1值+“;”+packagename(即:数字签名+分号+包名))安全码的获取方式如下：我们这边使用Eclipse直接查看: winows -> preferance-> android -> build。 如下图示：

     

   3:在之前的步骤中输入安全码,sha1值+我创建的应用的包名,点击确认，这样就配置OK了:截图如下:

      

 

    

   

(二)下面我们进入第二项工作,下载SDK

    我们要使用Baidu地图开发,我们首先要去下载开发sdk库,下载地址:http://developer.baidu.com/map/sdkandev-download.htm，注意：为了给用户提供更优质的服务，Android SDK自v2.1.3版本开始采用了全新的Key验证体系。因此，当您选择使用v2.1.3及之后版本的SDK时，需要到新的Key申请页面进行全新Key的申请，申请及配置流程请参考开发指南对应章节 。（选择使用v2.1.2及之前版本SDK的开发者，申请密钥（Key）的方式不变）。

  我这边直接下载全部:

  

 

(三)下面创建项目,来显示初步的显示一下百度地图:

       1.下载上面lib包，创建demo项目把jar和.so文件引入进去如下:

      

       2.自定义Applicaiton,设置全局变量BMapManager,并且进行验证。

     

[java] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. package com.ztt.baidumap.ui;  
  2.   
  3. import android.app.Application;  
  4. import android.content.Context;  
  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. /** 
  10.  * 自定义Application,进行key识别验证 （使用单例） 
  11.  * @author Jiangqq 
  12.  * @time 2014/03/15 10:14 
  13.  */  
  14. public class MyApplication extends Application {  
  15.     public static MyApplication instance=null;  
  16.     BMapManager mBMapManager = null;  
  17.     public boolean m_bKeyRight = true;  
  18.     public static final String strKey = "vUAGbPwLpolIqiwWisnQPeIE";  //百度地图官网申请的密钥  
  19.     public static MyApplication getInstance(){  
  20.         return instance;  
  21.     }  
  22.     @Override  
  23.     public void onCreate() {  
  24.         super.onCreate();  
  25.         instance=this;  
  26.         //在APP应用启动的时候，进行初始化验证  
  27.         initEngineManager(this);  
  28.     }  
  29.       
  30.     /** 
  31.      * 进行验证key 
  32.      * @param pContext 
  33.      */  
  34.     private void initEngineManager(Context pContext)  
  35.     {  
  36.          if (mBMapManager == null) {  
  37.                 mBMapManager = new BMapManager(pContext);  
  38.             }  
  39.   
  40.             if (!mBMapManager.init(strKey,new MyGeneralListener())) {  
  41.                 Toast.makeText(MyApplication.getInstance(),   
  42.                         "BMapManager  初始化错误!", Toast.LENGTH_LONG).show();  
  43.             }  
  44.     }  
  45.     // 常用事件监听，用来处理通常的网络错误，授权验证错误等  
  46.     static class MyGeneralListener implements MKGeneralListener {  
  47.           
  48.         @Override  
  49.         public void onGetNetworkState(int iError) {  
  50.             if (iError == MKEvent.ERROR_NETWORK_CONNECT) {  
  51.                 Toast.makeText(MyApplication.getInstance(), "您的网络出错啦！",  
  52.                     Toast.LENGTH_LONG).show();  
  53.             }  
  54.             else if (iError == MKEvent.ERROR_NETWORK_DATA) {  
  55.                 Toast.makeText(MyApplication.getInstance(), "输入正确的检索条件！",  
  56.                         Toast.LENGTH_LONG).show();  
  57.             }  
  58.             // ...  
  59.         }  
  60.   
  61.         @Override  
  62.         public void onGetPermissionState(int iError) {  
  63.             //非零值表示key验证未通过  
  64.             if (iError != 0) {  
  65.                 //授权Key错误：  
  66.                 Toast.makeText(MyApplication.getInstance(),   
  67.                         "请在 DemoApplication.java文件输入正确的授权Key,并检查您的网络连接是否正常！error: "+iError, Toast.LENGTH_LONG).show();  
  68.                 MyApplication.getInstance().m_bKeyRight = false;  
  69.             }  
  70.             else{  
  71.                 MyApplication.getInstance().m_bKeyRight = true;  
  72.                 Toast.makeText(MyApplication.getInstance(),   
  73.                         "key认证成功", Toast.LENGTH_LONG).show();  
  74.             }  
  75.         }  
  76.     }  
  77. }  

 2:MainActivity.java实现地图：

 

    布局文件如下:

   

[html] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  2.     xmlns:tools="http://schemas.android.com/tools"  
  3.     android:layout_width="match_parent"  
  4.     android:layout_height="match_parent"  
  5.  >  
  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.   
  12. </RelativeLayout>  

    实现代码:

 

   

[java] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. package com.ztt.baidumap.ui;  
  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.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.   
  15. /** 
  16.  * 进行演示百度地图的基本显示-可以进行创建百度地图和管理，演示百度地图的生命周期 
  17.  * @author Jiangqq 
  18.  * @time 2014/03/15  10:40 
  19.  */  
  20. public class MainActivity extends Activity {  
  21.     /** 
  22.      *  MapView 是地图主控件 
  23.      */  
  24.     private MapView mMapView = null;  
  25.     /** 
  26.      *  用MapController完成地图控制  
  27.      */  
  28.     private MapController mMapController = null;  
  29.     /** 
  30.      *  MKMapViewListener 用于处理地图事件回调 
  31.      */  
  32.     MKMapViewListener mMapListener = null;  
  33.     @Override  
  34.     protected void onCreate(Bundle savedInstanceState) {  
  35.         super.onCreate(savedInstanceState);  
  36.         /** 
  37.          * 使用地图sdk前需先初始化BMapManager. 
  38.          * BMapManager是全局的，可为多个MapView共用，它需要地图模块创建前创建， 
  39.          * 并在地图地图模块销毁后销毁，只要还有地图模块在使用，BMapManager就不应该销毁 
  40.          */  
  41.         MyApplication app = (MyApplication)this.getApplication();  
  42.         if (app.mBMapManager == null) {  
  43.             app.mBMapManager = new BMapManager(getApplicationContext());  
  44.             /** 
  45.              * 如果BMapManager没有初始化则初始化BMapManager 
  46.              */  
  47.             app.mBMapManager.init(MyApplication.strKey,new MyApplication.MyGeneralListener());  
  48.         }  
  49.         /** 
  50.           * 由于MapView在setContentView()中初始化,所以它需要在BMapManager初始化之后 
  51.           */  
  52.         setContentView(R.layout.main_layout);  
  53.           mMapView = (MapView)findViewById(R.id.bmapView);  
  54.             /** 
  55.              * 获取地图控制器 
  56.              */  
  57.             mMapController = mMapView.getController();  
  58.             /** 
  59.              *  设置地图是否响应点击事件  . 
  60.              */  
  61.             mMapController.enableClick(true);  
  62.             /** 
  63.              * 设置地图缩放级别 
  64.              */  
  65.             mMapController.setZoom(12);  
  66.              
  67.             /** 
  68.              * 将地图移动至指定点 
  69.              * 使用百度经纬度坐标，可以通过http://api.map.baidu.com/lbsapi/getpoint/index.html查询地理坐标 
  70.              * 如果需要在百度地图上显示使用其他坐标系统的位置，请发邮件至mapapi@baidu.com申请坐标转换接口 
  71.              */  
  72.             double cLat = 39.945;    
  73.             double cLon = 116.404;    
  74.             GeoPoint p = new GeoPoint((int) (cLat * 1E6), (int) (cLon * 1E6));   
  75.             mMapController.setCenter(p);  
  76.               
  77.             /** 
  78.              *  MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause() 
  79.              */  
  80.             mMapListener = new MKMapViewListener() {  
  81.                 @Override  
  82.                 public void onMapMoveFinish() {  
  83.                     /** 
  84.                      * 在此处理地图移动完成回调 
  85.                      * 缩放，平移等操作完成后，此回调被触发 
  86.                      */  
  87.                 }  
  88.                   
  89.                 @Override  
  90.                 public void onClickMapPoi(MapPoi mapPoiInfo) {  
  91.                     /** 
  92.                      * 在此处理底图poi点击事件 
  93.                      * 显示底图poi名称并移动至该点 
  94.                      * 设置过： mMapController.enableClick(true); 时，此回调才能被触发 
  95.                      *  
  96.                      */  
  97.                     String title = "";  
  98.                     if (mapPoiInfo != null){  
  99.                         title = mapPoiInfo.strText;  
  100.                         Toast.makeText(MainActivity.this,title,Toast.LENGTH_SHORT).show();  
  101.                         mMapController.animateTo(mapPoiInfo.geoPt);  
  102.                     }  
  103.                 }  
  104.   
  105.                 @Override  
  106.                 public void onGetCurrentMap(Bitmap b) {  
  107.                     /** 
  108.                      *  当调用过 mMapView.getCurrentMap()后，此回调会被触发 
  109.                      *  可在此保存截图至存储设备 
  110.                      */  
  111.                 }  
  112.   
  113.                 @Override  
  114.                 public void onMapAnimationFinish() {  
  115.                     /** 
  116.                      *  地图完成带动画的操作（如: animationTo()）后，此回调被触发 
  117.                      */  
  118.                 }  
  119.                 /** 
  120.                  * 在此处理地图载完成事件  
  121.                  */  
  122.                 @Override  
  123.                 public void onMapLoadFinish() {  
  124.                     Toast.makeText(MainActivity.this,   
  125.                                    "地图加载完成",   
  126.                                    Toast.LENGTH_SHORT).show();  
  127.                       
  128.                 }  
  129.             };  
  130.             mMapView.regMapViewListener(MyApplication.getInstance().mBMapManager, mMapListener);  
  131.     }  
  132.      @Override  
  133.         protected void onPause() {  
  134.             /** 
  135.              *  MapView的生命周期与Activity同步，当activity挂起时需调用MapView.onPause() 
  136.              */  
  137.             mMapView.onPause();  
  138.             super.onPause();  
  139.         }  
  140.           
  141.         @Override  
  142.         protected void onResume() {  
  143.             /** 
  144.              *  MapView的生命周期与Activity同步，当activity恢复时需调用MapView.onResume() 
  145.              */  
  146.             mMapView.onResume();  
  147.             super.onResume();  
  148.         }  
  149.           
  150.         @Override  
  151.         protected void onDestroy() {  
  152.             /** 
  153.              *  MapView的生命周期与Activity同步，当activity销毁时需调用MapView.destroy() 
  154.              */  
  155.             mMapView.destroy();  
  156.             super.onDestroy();  
  157.         }  
  158.           
  159.         @Override  
  160.         protected void onSaveInstanceState(Bundle outState) {  
  161.             super.onSaveInstanceState(outState);  
  162.             mMapView.onSaveInstanceState(outState);  
  163.               
  164.         }  
  165.           
  166.         @Override  
  167.         protected void onRestoreInstanceState(Bundle savedInstanceState) {  
  168.             super.onRestoreInstanceState(savedInstanceState);  
  169.             mMapView.onRestoreInstanceState(savedInstanceState);  
  170.         }  
  171. }  

  3:加入权限配置:

 

   

[html] view plaincopy在CODE上查看代码片派生到我的代码片
 
  1. <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />  
  2.    <uses-permission android:name="android.permission.BAIDU_LOCATION_SERVICE" />  
  3.    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
  4.    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
  5.    <uses-permission android:name="android.permission.INTERNET" />  
  6.    <uses-permission android:name="android.permission.ACCES_MOCK_LOCATION" />  
  7.    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />  
  8.    <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />  
  9.    <uses-permission android:name="android.permission.WAKE_LOCK" />  
  10.    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />  
  11.    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />  
  12.    <uses-permission android:name="android.permission.ACCESS_GPS" />  
  13.    <!-- SDK1.5需要android.permission.GET_TASKS权限判断本程序是否为当前运行的应用? -->  
  14.    <uses-permission android:name="android.permission.GET_TASKS" />  
  15.    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
  16.    <uses-permission android:name="android.permission.BROADCAST_STICKY" />  
  17.    <uses-permission android:name="android.permission.WRITE_SETTINGS" />  
  18.    <!-- 来电消音 -->  
  19.    <uses-permission android:name="android.permission.PROCESS_OUTGOING_CALLS" />  
  20.    <uses-permission android:name="android.permission.READ_PHONE_STATE" />  
  21.    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />  
  22.    <uses-permission android:name="android.permission.RECORD_AUDIO" />  

  4: 运行截图:

 

 

(四):代码中实现百度地图用的几个类简要说明:

       1:MapController:地图引擎管理类：BMapManager据有Application级别的生命周期，BMapManager应在sdk功能模块使用前初始化， 并且在sdk功能模块销毁后销毁.

       2:MapView:一个显示地图的视图，当被焦点选中时，它能捕获按键事件和触摸手势去平移和缩放地图。MapView的创建可以使用在XML布局的方式创建，也可以使用构建函           数创建MapView的生命周期需要与Activity同步，即需要在Activity.onPause中调用onPause(), 在Activity.onResume中调用onResume(),在Activity.onDestroy中调用destory();

我的专栏