Android教程網
  1. 首頁
  2. Android 技術
  3. Android 手機
  4. Android 系統教程
  5. Android 游戲
 Android教程網 >> Android技術 >> Android開發實例 >> Android百度地圖開發教程(一)API key申請及地圖使用示例

Android百度地圖開發教程(一)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。 如下圖示:
 


然後我們使用keytool工具來獲取簽名證書的sha1值,在DOS輸入keytool -list -keystore C:\Users\bds\.android\debug.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開發包,下載地址http://developer.baidu.com/map/sdkandev-download.htm,下載Android SDKv2.1.3 lib庫就行了

 

 

三、在Android項目中引用百度地圖


新建Android項目 BaiduMapDemo,然後將百度地圖API庫加入工程,如下圖
 

 


 

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

  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界面代碼,注釋的很詳細,相信你看得懂
 

  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.     MKMapViewListener mMapListener = null;  
  32.  
  33.     @Override 
  34.     protected void onCreate(Bundle savedInstanceState) {  
  35.         super.onCreate(savedInstanceState);  
  36.         /**  
  37.          * 使用地圖sdk前需先初始化BMapManager,這個必須在setContentView()先初始化  
  38.          */ 
  39.         mBMapManager = new BMapManager(this);  
  40.           
  41.         //第一個參數是API key,  
  42.         //第二個參數是常用事件監聽,用來處理通常的網絡錯誤,授權驗證錯誤等,你也可以不添加這個回調接口  
  43.         mBMapManager.init("7ae13368159d6a513eaa7a17b9413b4b", new MKGeneralListener() {  
  44.               
  45.             //授權錯誤的時候調用的回調函數  
  46.             @Override 
  47.             public void onGetPermissionState(int iError) {  
  48.                 if (iError ==  MKEvent.ERROR_PERMISSION_DENIED) {  
  49.                     showToast("API KEY錯誤, 請檢查!");  
  50.                 }  
  51.             }  
  52.               
  53.             //一些網絡狀態的錯誤處理回調函數  
  54.             @Override 
  55.             public void onGetNetworkState(int iError) {  
  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.         GeoPoint p = new GeoPoint((int)(22.547923 * 1E6), (int)(114.067368 * 1E6));  
  89.         //設置p地方為中心點  
  90.         mMapController.setCenter(p);  
  91.         mMapView.regMapViewListener(mBMapManager, new MKMapViewListener() {  
  92.               
  93.             /**  
  94.              * 地圖移動完成時會回調此接口 方法  
  95.              */ 
  96.             @Override 
  97.             public void onMapMoveFinish() {  
  98.                 showToast("地圖移動完畢!");  
  99.             }  
  100.               
  101.             /**  
  102.              * 地圖加載完畢回調此接口方法  
  103.              */ 
  104.             @Override 
  105.             public void onMapLoadFinish() {  
  106.                 showToast("地圖載入完畢!");  
  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.             mBMapManager = 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.             mToast = Toast.makeText(this, msg, Toast.LENGTH_SHORT);    
  180.         }else{    
  181.             mToast.setText(msg);    
  182.             mToast.setDuration(Toast.LENGTH_SHORT);  
  183.         }    
  184.         mToast.show();    
  185.     }   
  186.       
  187.       

 

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,也簡單實現了裡面的幾個方法,接下來我會帶著大家詳細的了解這裡面的方法,

當然,我們在程序運行之前,還必須加入相對應的權限

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

運行結果
 


 
 

轉自:http://blog. csdn. net/ xiaanming/ article/details/11171581

 

  1. 上一頁:
  2. 下一頁:
熱門文章
閱讀排行版
Copyright © Android教程網 All Rights Reserved