百度地圖開發1
最近自己想研究下地圖,本來想研究google Map,但是申請API key比較坑爹,於是從百度地圖入手,其實他們的用法都差不多,本篇文章就帶領大家在自己的Android項目中加入百度地圖的功能,接下來我會寫一係列關於百度地圖的文章,歡迎大家到時候關注!
一 申請API key
- 在使用百度地圖之前,我們必須去申請一個百度地圖的API key,申請地址https://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開發包,下載地址https://developer.baidu.com/map/sdkandev-download.htm,下載Android
SDKv2.1.3 lib庫就行了
三、在Android項目中引用百度地圖
- 新建Android項目 BaiduMapDemo,然後將百度地圖API庫加入工程,如下圖
- 在布局文件中添加百度地圖控件,
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout xmlns:android="https://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" />
- 運行結果


好了,今天的講解到此結束,有疑問的朋友請在下麵留言。之後會持續介紹百度地圖的使用,歡迎大家關注
最後更新:2017-04-03 12:55:36