Android 百度地圖開發(一)--- 申請API Key和在項目中顯示百度地圖

轉載請註明地址http://blog.csdn.net/xiaanming/article/details/11171581html

近期本身想研究下地圖,原本想研究google Map,但是申請API key比較坑爹,因而從百度地圖入手,事實上他們的使用方法都差點兒相同,本篇文章就帶領你們在本身的Android項目中增長百度地圖的功能,接下來我會寫一系列關於百度地圖的文章,歡迎你們到時候關注!java


一 申請API keyandroid

  • 在使用百度地圖以前,咱們必須去申請一個百度地圖的API key,申請地址http://lbsyun.baidu.com/apiconsole/key,本身自行註冊一個百度帳號,很是快就能申請到的,例如如下圖


  • 點擊"建立密鑰",系統將爲咱們本身主動生成密鑰,固然咱們在使用密鑰以前還必須配置,點擊"設置"例如如下圖



Key type 選擇「for mobile」,安全碼是Android簽名證書的證書指紋 (SHA1)值 + 「;」 + 你的應用程序包名,因此當你配置好了API key 你不能任意更換應用程序的包名, 假設更換了包名咱們需要又一次配置API key,接下來咱們來介紹怎麼獲取數字簽名api

咱們知道咱們開發的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 keyapp


下載百度地圖API庫eclipse

要在Android應用中使用百度地圖API,就需要在project中引用百度地圖API開發包,下載地址http://developer.baidu.com/map/sdkandev-download.htm,下載Android SDKv2.1.3 lib庫便可了
ide


3、在Android項目中引用百度地圖函數

  • 新建Android項目 BaiduMapDemo,而後將百度地圖API庫增長project,例如如下圖


  • 在佈局文件裏增長百度地圖控件,

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >

    <com.baidu.mapapi.map.MapView
        android:id="@+id/bmapView"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:clickable="true" />

</LinearLayout>

  • Activity界面代碼,凝視的很是具體,相信你看得懂

package com.example.baidumapdemo;

import android.app.Activity;
import android.graphics.Bitmap;
import android.os.Bundle;
import android.widget.Toast;

import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.MKGeneralListener;
import com.baidu.mapapi.map.MKEvent;
import com.baidu.mapapi.map.MKMapViewListener;
import com.baidu.mapapi.map.MapController;
import com.baidu.mapapi.map.MapPoi;
import com.baidu.mapapi.map.MapView;
import com.baidu.platform.comapi.basestruct.GeoPoint;

public class MainActivity extends Activity {
	private Toast mToast;
	private BMapManager mBMapManager;
	/**
	 * MapView 是地圖主控件
	 */
	private MapView mMapView = null;
	/**
	 * 用MapController完畢地圖控制
	 */
	private MapController mMapController = null;
	/**
	 * MKMapViewListener 用於處理地圖事件回調
	 */
	MKMapViewListener mMapListener = null;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		/**
		 * 使用地圖sdk前需先初始化BMapManager,這個必須在setContentView()先初始化
		 */
		mBMapManager = new BMapManager(this);
		
		//第一個參數是API key,
		//第二個參數是常常使用事件監聽,用來處理一般的網絡錯誤,受權驗證錯誤等,你也可以不增長這個回調接口
		mBMapManager.init("7ae13368159d6a513eaa7a17b9413b4b", new MKGeneralListener() {
			
			//受權錯誤的時候調用的回調函數
			@Override
			public void onGetPermissionState(int iError) {
				if (iError ==  MKEvent.ERROR_PERMISSION_DENIED) {
					showToast("API KEY錯誤, 請檢查!");
	            }
			}
			
			//一些網絡狀態的錯誤處理回調函數
			@Override
			public void onGetNetworkState(int iError) {
				if (iError == MKEvent.ERROR_NETWORK_CONNECT) {
					Toast.makeText(getApplication(), "您的網絡出錯啦!", Toast.LENGTH_LONG).show();
	            }
			}
		});
		
		
		setContentView(R.layout.activity_main);
		
		mMapView = (MapView) findViewById(R.id.bmapView);
		
		  /**
         * 獲取地圖控制器
         */
        mMapController = mMapView.getController();
        /**
         *  設置地圖是否響應點擊事件  .
         */
        mMapController.enableClick(true);
        /**
         * 設置地圖縮放級別
         */
        mMapController.setZoom(12);
        
        /**
         * 顯示內置縮放控件
         */
        mMapView.setBuiltInZoomControls(true);
        
        /**
         * 保存精度和緯度的類,
         */
        GeoPoint p = new GeoPoint((int)(22.547923 * 1E6), (int)(114.067368 * 1E6));
        //設置p地方爲中心點
        mMapController.setCenter(p);
        mMapView.regMapViewListener(mBMapManager, new MKMapViewListener() {
			
        	/**
        	 * 地圖移動完畢時會回調此接口 方法
        	 */
			@Override
			public void onMapMoveFinish() {
				showToast("地圖移動完畢!");
			}
			
			/**
			 * 地圖載入完畢回調此接口方法
			 */
			@Override
			public void onMapLoadFinish() {
				showToast("地圖載入完畢!");
			}
			
			/**
			 *  地圖完畢帶動畫的操做(如: animationTo())後,此回調被觸發
			 */
			@Override
			public void onMapAnimationFinish() {
				
			}
			
			/**
			 *  當調用過 mMapView.getCurrentMap()後,此回調會被觸發
			 *  可在此保存截圖至存儲設備
			 */
			@Override
			public void onGetCurrentMap(Bitmap arg0) {
				
			}
			
			/**
			 * 點擊地圖上被標記的點回調此方法
			 * 
			 */
			@Override
			public void onClickMapPoi(MapPoi arg0) {
				if (arg0 != null){
					showToast(arg0.strText);
				}
			}
		});
	}


	
	@Override
	protected void onResume() {
    	//MapView的生命週期與Activity同步,當activity掛起時需調用MapView.onPause()
		mMapView.onResume();
		super.onResume();
	}



	@Override
	protected void onPause() {
		//MapView的生命週期與Activity同步,當activity掛起時需調用MapView.onPause()
		mMapView.onPause();
		super.onPause();
	}

	@Override
	protected void onDestroy() {
		//MapView的生命週期與Activity同步,當activity銷燬時需調用MapView.destroy()
		mMapView.destroy();
		
		//退出應用調用BMapManager的destroy()方法
		if(mBMapManager != null){
			mBMapManager.destroy();
			mBMapManager = null;
		}
		
		super.onDestroy();
	}

	
	
	 /** 
     * 顯示Toast消息 
     * @param msg 
     */  
    private void showToast(String msg){  
        if(mToast == null){  
            mToast = Toast.makeText(this, msg, Toast.LENGTH_SHORT);  
        }else{  
            mToast.setText(msg);  
            mToast.setDuration(Toast.LENGTH_SHORT);
        }  
        mToast.show();  
    } 
	
	
}

  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,也簡單實現了裏面的幾個方法,接下來我會帶着你們具體的瞭解這裏面的方法,但願你們到時候關注個人博客

  • 固然,咱們在程序執行以前,還必須增長相相應的權限

  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />  
    <uses-permission android:name="android.permission.INTERNET" />  
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />  
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />  
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />

  • 執行結果



好了,今天的解說到此結束,有疑問的朋友請在如下留言。以後會持續介紹百度地圖的使用,歡迎你們關注

相關文章
相關標籤/搜索