轉載請注明地址http://blog.csdn.net/xiaanming/article/details/11171581
近期自己想研究下地圖，本來想研究google Map，可是申請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，就須要在project中引用百度地圖API開發包，下載地址http://developer.baidu.com/map/sdkandev-download.htm，下載Android SDKv2.1.3 lib庫即可了
三、在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();
}
}
- 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，也簡單實現了里面的幾個方法，接下來我會帶着大家具體的了解這里面的方法，希望大家到時候關注我的博客
- 當然，我們在程序執行之前，還必須增加相相應的權限
<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" />
- 執行結果
