基于Android SDK離線地圖功能的實現(xiàn)

摘要：針對手機地圖功能進行分析，為了帶來更好的地圖體驗并節(jié)省流量，在借鑒百度地圖 Android SDK的基礎(chǔ)上，實現(xiàn)了一款實用方便的手機離線地圖。

關(guān)鍵詞：手機；百度地圖Android SDK；離線地圖

中圖分類號：TP393 文獻標識碼：A 文章編號：1009-3044（2014）18-4172-03

Realization of Offline Map based on Android SDK

ZHANG Guo-hai

（Guangzhou Civil Aviation College， Guangzhou 510403， China）

Abstract： In order to bring better experience and save flow， based on Baidu map android SDK and the analysis of the function of mobile phone map， implemented a practical and convenient offline mobile map.

Key words： Mobile； Baidu map android SDK； offline map

隨著移動網(wǎng)絡(luò)時代發(fā)展步伐的不斷加快，市面上如街景地圖、高德導(dǎo)航和百度地圖等基于位置服務(wù)（LBS：Location Based Service）軟件給人們生活帶來了實質(zhì)性的變化。人們出行不再像以前依賴紙質(zhì)地圖和指南針，只需在手機屏幕上輕松點擊，便可以輕松實現(xiàn)自主導(dǎo)航[1]。該文中實現(xiàn)的離線地圖功能是基于百度地圖 Android SDK開發(fā)而成，百度地圖 Android SDK是一套基于Android 2.1及以上版本設(shè)備的應(yīng)用程序接口。 您可以使用該套 SDK開發(fā)適用于Android系統(tǒng)移動設(shè)備的地圖應(yīng)用，通過調(diào)用地圖SDK接口，您可以輕松訪問百度地圖服務(wù)和數(shù)據(jù)， 構(gòu)建功能豐富、交互性強的地圖類應(yīng)用程序[2]。

1 工程配置

百度地圖Android SDK提供的所有服務(wù)是免費的，接口使用無次數(shù)限制。只有申請密鑰（key）后，才可使用百度地圖Android SDK。開發(fā)者可以在http：//developer.baidu.com/map/sdkandev-14.htm申請密鑰。開發(fā)離線地圖，申請密鑰后，還要下載jar包和離線地圖。該文所使用的是baidumapapi_v2_4_1.jar包。

1.1 jar包導(dǎo)入到項目

Jar包下載后，要進行如下操作才可使用：

1）在工程里新建libs文件夾（若不存在的話），將開發(fā)包里的baidumapapi_v2_1_1.jar拷貝到libs根目錄下，將libapp_BaiduMapApplib_v2_1_1.so拷貝到libs＼armeabi目錄下。如圖1所示。

圖1 libs目錄結(jié)構(gòu)

2）項目屬性中Java Build Path→Order and Export中，確定Android Private Libaries與Android Dependencies這兩項前面的選擇框被選上后，確定。

3）菜單Project→clean重新編譯項目后就可以正常使用地圖中的功能進行編程了。

1.2 離線地圖導(dǎo)入SD卡

下載的離線包解壓后，把其中的vmp文件夾拷入SD卡根目錄下的BaiduMapSdk文件夾內(nèi)。

2 離線地圖功能的實現(xiàn)

首先在Manifest中添加使用權(quán)限、Android版本及屏幕支持和對應(yīng)的開發(fā)密鑰，具體代碼可參考http：//developer.baidu.com/map/sdkandev-2.htm。該文開發(fā)的離線地圖有兩個界面，一個主界面，用于顯示下載的離線城市地圖，另一個用于顯示離線城市地圖，可顯示普通地圖、衛(wèi)星圖和實時交通圖。

2.1 離線地圖開發(fā)使用的主要類

1）MapView 顯示地圖的視圖，當被焦點選中時，它能捕獲按鍵事件和觸摸手勢去平移和縮放地圖。MapView的創(chuàng)建可以使用在XML布局的方式創(chuàng)建，也可以使用構(gòu)建函數(shù)創(chuàng)建。MapView的生命周期需要與Activity同步，即需要在Activity.onPause中調(diào)用onPause（）， 在Activity.onResume中調(diào)用onResume（），在Activity.onDestroy中調(diào)用 destroy（）。

2）MapController，地圖控制器，MapController的方法主要是對地圖的放大縮小，俯視旋轉(zhuǎn)，手勢鍵盤處理，指南針位置，動畫等。主要方法有setCenter，函數(shù)原型

public void setCenter（GeoPoint point）功能是在給定的中心點GeoPoint上設(shè)置地圖視圖。

方法setZoom，函數(shù)原型public float setZoom（float zoomLevel）功能是設(shè)置地圖的縮放級別。這個值的取值范圍是[3，19]。

3）BmapManager 地圖引擎管理類，BmapManager具有Application級別的生命周期，BMapManager應(yīng)在sdk功能模塊使用前初始化， 并且在sdk功能模塊銷毀后銷毀。

4）MKOfflineMap 實現(xiàn)離線地圖服務(wù)，用于離線地圖的管理。主要方法有：

Init，函數(shù)原型public boolean init（MapController mapCtr， MKOfflineMapListener listener）

初使化MKOfflineMap ，mapCtr參數(shù)為初始化離線地圖模塊所需要的MapController對象。

scan，函數(shù)原型public int scan（boolean bDeleteFailed）作用是導(dǎo)入離線地圖包。

getAllUpdateInfo，函數(shù)原型

public java.util.ArrayList getAllUpdateInfo（）作用是返回各城市離線地圖更新信息。

getUpdateInfo，函數(shù)原型public MKOLUpdateElement getUpdateInfo（int cityID）返回指定城市ID離線地圖更新信息。

remove，函數(shù)原型public boolean remove（int cityID）刪除指定城市ID的離線地圖。

2.2 application類

因為地圖引擎管理類BmapManager具有Application級別的生命周期，BMapManager應(yīng)在sdk功能模塊使用前初始化， 并且在sdk功能模塊銷毀后銷毀，因此要構(gòu)造一個繼承application類來實現(xiàn)對BmapManager管理。BmapManager初始化放在繼承application類中實現(xiàn)。

2.3 界面設(shè)計

界面分為主界面和離線地圖顯示界面。主界面如圖2所示：

圖2 主界面 圖3 地圖顯示界面

圖2中，“已下載城市地圖”TextView控件下面為一個ListView控件，用于顯示已經(jīng)下載的城市地圖列表。圖3中“普通圖”、“衛(wèi)星圖”和“交通圖”用于切換顯示不同的地圖，下面MapView控件用于顯示選擇的地圖。

2.4 離線地圖功能實現(xiàn)

2.4.1離線地圖的顯示

離線地圖的顯示在一個繼承自Activity類中實現(xiàn)。首先在類中實例化兩個對象MapView，MapController，用于地圖的控制和顯示。然后在OnCreate函數(shù)中對這兩個對象進行初始化。

初始化離線地圖的核心代碼如下：

myapplication app = （myapplication）this.getApplication（）；

if （app.mBMapManager == null） {

app.mBMapManager = new BMapManager（getApplicationContext（））；

// 如果BMapManager沒有初始化則初始化BMapManager

app.mBMapManager.init（new myapplication.MyGeneralListener（））；

}

setContentView（R.layout.display_map）；

mMapView = （MapView）findViewById（R.id.bmapView）；

mMapController = mMapView.getController（）；

// 設(shè)置地圖縮放級別

mMapView.setBuiltInZoomControls（true）；

mMapController.setZoom（12）；

GeoPoint p ；

double cLat = 39.945 ；

double cLon = 116.404 ；

Intent intent = getIntent（）；

if （ intent.hasExtra（"x"） && intent.hasExtra（"y"） ）{

Bundle b = intent.getExtras（）；

p = new GeoPoint（b.getInt（"y"）， b.getInt（"x"））；

}else{

p = new GeoPoint（（int）（cLat * 1E6）， （int）（cLon * 1E6））；

}

mMapController.setCenter（p）；

并重寫onDestroy（），onPause（）和onResume（）方法。onResume（）方法如下：

protected void onResume（）{

mMapView.onResume（）；

myapplication app = （myapplication）this.getApplication（）；

if（app.mBMapManager！=null）{

app.mBMapManager.start（）；

}

super.onResume（）；

}

2.4.2顯示模式的切換

顯示模式的切換可在“普通圖”、“衛(wèi)星圖”和“交通圖”這三個按鈕控件的消息響應(yīng)函數(shù)中處理。是否打開路況圖可調(diào)用MapView類中的成員函數(shù)setTraffic（boolean on）來設(shè)置，是否打開衛(wèi)星圖可調(diào)用MapView類中的成員函數(shù)setSatellite（boolean on）來設(shè)置。程序在真機上運行效果如圖4和圖5所示。

圖4 衛(wèi)星圖 圖5 普通圖

3 結(jié)束語

本文利用了Android手機平臺和百度地圖Android SDK，完成了離線地圖功能的實現(xiàn)。程序在Android Developer Tools v22.3.0平臺上，利用真機進行了測試，效果良好。

參考文獻：

[1] 李瑞宣，王山東，徐志遠，等. 基于Android平臺定位系統(tǒng)設(shè)計和實現(xiàn)[J]. 信息技術(shù)，2013（12）：187-190.

[2]百度地圖Android SDK開發(fā)指南[EB/OL]. http：//developer.baidu.com/map/sdk-android.htm.

Init，函數(shù)原型public boolean init（MapController mapCtr， MKOfflineMapListener listener）

初使化MKOfflineMap ，mapCtr參數(shù)為初始化離線地圖模塊所需要的MapController對象。

scan，函數(shù)原型public int scan（boolean bDeleteFailed）作用是導(dǎo)入離線地圖包。

getAllUpdateInfo，函數(shù)原型

public java.util.ArrayList getAllUpdateInfo（）作用是返回各城市離線地圖更新信息。

getUpdateInfo，函數(shù)原型public MKOLUpdateElement getUpdateInfo（int cityID）返回指定城市ID離線地圖更新信息。

remove，函數(shù)原型public boolean remove（int cityID）刪除指定城市ID的離線地圖。

2.2 application類

因為地圖引擎管理類BmapManager具有Application級別的生命周期，BMapManager應(yīng)在sdk功能模塊使用前初始化， 并且在sdk功能模塊銷毀后銷毀，因此要構(gòu)造一個繼承application類來實現(xiàn)對BmapManager管理。BmapManager初始化放在繼承application類中實現(xiàn)。

2.3 界面設(shè)計

界面分為主界面和離線地圖顯示界面。主界面如圖2所示：

圖2 主界面 圖3 地圖顯示界面

圖2中，“已下載城市地圖”TextView控件下面為一個ListView控件，用于顯示已經(jīng)下載的城市地圖列表。圖3中“普通圖”、“衛(wèi)星圖”和“交通圖”用于切換顯示不同的地圖，下面MapView控件用于顯示選擇的地圖。

2.4 離線地圖功能實現(xiàn)

2.4.1離線地圖的顯示

離線地圖的顯示在一個繼承自Activity類中實現(xiàn)。首先在類中實例化兩個對象MapView，MapController，用于地圖的控制和顯示。然后在OnCreate函數(shù)中對這兩個對象進行初始化。

初始化離線地圖的核心代碼如下：

myapplication app = （myapplication）this.getApplication（）；

if （app.mBMapManager == null） {

app.mBMapManager = new BMapManager（getApplicationContext（））；

// 如果BMapManager沒有初始化則初始化BMapManager

app.mBMapManager.init（new myapplication.MyGeneralListener（））；

}

setContentView（R.layout.display_map）；

mMapView = （MapView）findViewById（R.id.bmapView）；

mMapController = mMapView.getController（）；

// 設(shè)置地圖縮放級別

mMapView.setBuiltInZoomControls（true）；

mMapController.setZoom（12）；

GeoPoint p ；

double cLat = 39.945 ；

double cLon = 116.404 ；

Intent intent = getIntent（）；

if （ intent.hasExtra（"x"） && intent.hasExtra（"y"） ）{

Bundle b = intent.getExtras（）；

p = new GeoPoint（b.getInt（"y"）， b.getInt（"x"））；

}else{

p = new GeoPoint（（int）（cLat * 1E6）， （int）（cLon * 1E6））；

}

mMapController.setCenter（p）；

并重寫onDestroy（），onPause（）和onResume（）方法。onResume（）方法如下：

protected void onResume（）{

mMapView.onResume（）；

myapplication app = （myapplication）this.getApplication（）；

if（app.mBMapManager！=null）{

app.mBMapManager.start（）；

}

super.onResume（）；

}

2.4.2顯示模式的切換

顯示模式的切換可在“普通圖”、“衛(wèi)星圖”和“交通圖”這三個按鈕控件的消息響應(yīng)函數(shù)中處理。是否打開路況圖可調(diào)用MapView類中的成員函數(shù)setTraffic（boolean on）來設(shè)置，是否打開衛(wèi)星圖可調(diào)用MapView類中的成員函數(shù)setSatellite（boolean on）來設(shè)置。程序在真機上運行效果如圖4和圖5所示。

圖4 衛(wèi)星圖 圖5 普通圖

3 結(jié)束語

本文利用了Android手機平臺和百度地圖Android SDK，完成了離線地圖功能的實現(xiàn)。程序在Android Developer Tools v22.3.0平臺上，利用真機進行了測試，效果良好。

參考文獻：

[1] 李瑞宣，王山東，徐志遠，等. 基于Android平臺定位系統(tǒng)設(shè)計和實現(xiàn)[J]. 信息技術(shù)，2013（12）：187-190.

[2]百度地圖Android SDK開發(fā)指南[EB/OL]. http：//developer.baidu.com/map/sdk-android.htm.

Init，函數(shù)原型public boolean init（MapController mapCtr， MKOfflineMapListener listener）

初使化MKOfflineMap ，mapCtr參數(shù)為初始化離線地圖模塊所需要的MapController對象。

scan，函數(shù)原型public int scan（boolean bDeleteFailed）作用是導(dǎo)入離線地圖包。

getAllUpdateInfo，函數(shù)原型

public java.util.ArrayList getAllUpdateInfo（）作用是返回各城市離線地圖更新信息。

getUpdateInfo，函數(shù)原型public MKOLUpdateElement getUpdateInfo（int cityID）返回指定城市ID離線地圖更新信息。

remove，函數(shù)原型public boolean remove（int cityID）刪除指定城市ID的離線地圖。

2.2 application類

因為地圖引擎管理類BmapManager具有Application級別的生命周期，BMapManager應(yīng)在sdk功能模塊使用前初始化， 并且在sdk功能模塊銷毀后銷毀，因此要構(gòu)造一個繼承application類來實現(xiàn)對BmapManager管理。BmapManager初始化放在繼承application類中實現(xiàn)。

2.3 界面設(shè)計

界面分為主界面和離線地圖顯示界面。主界面如圖2所示：

圖2 主界面 圖3 地圖顯示界面

圖2中，“已下載城市地圖”TextView控件下面為一個ListView控件，用于顯示已經(jīng)下載的城市地圖列表。圖3中“普通圖”、“衛(wèi)星圖”和“交通圖”用于切換顯示不同的地圖，下面MapView控件用于顯示選擇的地圖。

2.4 離線地圖功能實現(xiàn)

2.4.1離線地圖的顯示

離線地圖的顯示在一個繼承自Activity類中實現(xiàn)。首先在類中實例化兩個對象MapView，MapController，用于地圖的控制和顯示。然后在OnCreate函數(shù)中對這兩個對象進行初始化。

初始化離線地圖的核心代碼如下：

myapplication app = （myapplication）this.getApplication（）；

if （app.mBMapManager == null） {

app.mBMapManager = new BMapManager（getApplicationContext（））；

// 如果BMapManager沒有初始化則初始化BMapManager

app.mBMapManager.init（new myapplication.MyGeneralListener（））；

}

setContentView（R.layout.display_map）；

mMapView = （MapView）findViewById（R.id.bmapView）；

mMapController = mMapView.getController（）；

// 設(shè)置地圖縮放級別

mMapView.setBuiltInZoomControls（true）；

mMapController.setZoom（12）；

GeoPoint p ；

double cLat = 39.945 ；

double cLon = 116.404 ；

Intent intent = getIntent（）；

if （ intent.hasExtra（"x"） && intent.hasExtra（"y"） ）{

Bundle b = intent.getExtras（）；

p = new GeoPoint（b.getInt（"y"）， b.getInt（"x"））；

}else{

p = new GeoPoint（（int）（cLat * 1E6）， （int）（cLon * 1E6））；

}

mMapController.setCenter（p）；

并重寫onDestroy（），onPause（）和onResume（）方法。onResume（）方法如下：

protected void onResume（）{

mMapView.onResume（）；

myapplication app = （myapplication）this.getApplication（）；

if（app.mBMapManager！=null）{

app.mBMapManager.start（）；

}

super.onResume（）；

}

2.4.2顯示模式的切換

顯示模式的切換可在“普通圖”、“衛(wèi)星圖”和“交通圖”這三個按鈕控件的消息響應(yīng)函數(shù)中處理。是否打開路況圖可調(diào)用MapView類中的成員函數(shù)setTraffic（boolean on）來設(shè)置，是否打開衛(wèi)星圖可調(diào)用MapView類中的成員函數(shù)setSatellite（boolean on）來設(shè)置。程序在真機上運行效果如圖4和圖5所示。

圖4 衛(wèi)星圖 圖5 普通圖

3 結(jié)束語

本文利用了Android手機平臺和百度地圖Android SDK，完成了離線地圖功能的實現(xiàn)。程序在Android Developer Tools v22.3.0平臺上，利用真機進行了測試，效果良好。

參考文獻：

[1] 李瑞宣，王山東，徐志遠，等. 基于Android平臺定位系統(tǒng)設(shè)計和實現(xiàn)[J]. 信息技術(shù)，2013（12）：187-190.

[2]百度地圖Android SDK開發(fā)指南[EB/OL]. http：//developer.baidu.com/map/sdk-android.htm.