android学习：初学百度地图编程

    相信对于每个IT人士来说，android的编程大家并不陌生。简单的编程方法这里不赘述。

    笔者在实际应用中，运用到百度地图的相关编程，之所以选择百度而不选择谷歌地图，这个大家都懂的。

    查阅了很多资料，尤其是这篇文章给我的收获较大：http://blog.youkuaiyun.com/xiaanming/article/details/11171581，以下简称“原始教程”。

但是当笔者按照文章的代码运行的时候，却无意外的奔溃。于是结合百度官方提供的例子（官方提供的例子较为复杂），自己完成了百度地图初级的调用，写下此文章，供初学百度地图的朋友们参考。

一 申请API

    这个是必须的第一步，网址：http://lbsyun.baidu.com/apiconsole/key，也很简单，只要注册一个百度账号，申请一下就可以了

   如图，笔者已经创建了两个应用（百度的规则是一个AK对应一个应用），如果想要创建新的应用，只要点击创建应用就可以了，服务器端的AK是系统自动生成的。

应用名称就填写你所创建应用的名称，笔者这里用smartHome代替，应用类型就选择for Mobile（其他选项没试过），主要就是安全码这个东西，官方的解释是Android签名证书的证书指纹 (SHA1)值 + “;” + 你的应用程序包名，这两个东西如何获取呢：

1.签名证书指纹，在你所使用的eclipse下的：winows -> preferance -> android -> build中即可查看

2.应用程序包名：这个大多数教程解释的比较模糊，其实就是eclipse建立好工程之后，在Andoirdmanifest.xml文件中packet所对应的值，注意是双引号里面的值，不包括双引号，切记！

二.下载百度API的库

    下载地址：http://developer.baidu.com/map/sdkandev-download.htm，建议初学者下载完整包，因为百度自带了一个Demo工程，里面百度地图的许多用法都应用上了，可以方便学习。

三.在项目中添加

   把里面的库导入，这里我是参考了百度官方自带的Demo例程导入的，依葫芦画瓢，不难

    至此，百度地图编程之前的环境就搭建好了。下面真正计入代码部分：

1.布局文件中添加控件：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
  xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent">
    
     <com.baidu.mapapi.map.MapView 
    android:id="@+id/bmapView"
	android:layout_width="fill_parent" 
	android:layout_height="fill_parent" 
	android:clickable="true"     
/>

</LinearLayout>

    注意此处用的控件是百度jar包中的文件，而不是安卓自带的MapView

2.修改AndroidManifest.xml中，设置相应的权限，笔者一开始依照原始教程中的权限设置，一直处于程序奔溃状态，所以采用百度官方自带的Demo中的权限设置：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.smarthome"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="8"
        android:targetSdkVersion="18" />
    
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name="com.example.smarthome.MainActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
    
        <uses-permission android:name="android.permission.GET_ACCOUNTS" />
    <uses-permission android:name="android.permission.USE_CREDENTIALS" />
    <uses-permission android:name="android.permission.MANAGE_ACCOUNTS" />
    <uses-permission android:name="android.permission.AUTHENTICATE_ACCOUNTS" />

    <permission android:name="android.permission.BAIDU_LOCATION_SERVICE" >
    </permission>

    <uses-permission android:name="android.permission.BAIDU_LOCATION_SERVICE" >
    </uses-permission>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" >
    </uses-permission>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" >
    </uses-permission>
    <uses-permission android:name="android.permission.INTERNET" >
    </uses-permission>
    <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" >
    </uses-permission>
    <!-- <uses-permission android:name="android.permission.WRITE_APN_SETTINGS"></uses-permission> -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" >
    </uses-permission>
    <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
    <uses-permission android:name="android.permission.WAKE_LOCK" >
    </uses-permission>
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_GPS" />
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.READ_CONTACTS" />
    <uses-permission android:name="android.permission.CALL_PHONE" />
    <uses-permission android:name="android.permission.READ_SMS" />
    <uses-permission android:name="android.permission.SEND_SMS" />
    <!-- SDK1.5需要android.permission.GET_TASKS权限判断本程序是否为当前运行的应用? -->
    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.CAMERA" >
    </uses-permission>
    <uses-permission android:name="android.permission.RECORD_AUDIO" >
    </uses-permission>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" >
    </uses-permission>
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
    <uses-permission android:name="android.permission.BROADCAST_STICKY" />
    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
    <!-- 来电消音 -->
    <uses-permission android:name="android.permission.PROCESS_OUTGOING_CALLS" >
    </uses-permission>
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
    
    
    <supports-screens
        android:anyDensity="true"
        android:largeScreens="true"
        android:normalScreens="true"
        android:resizeable="true"
        android:smallScreens="true" />
</manifest>

3. Activity界面代码，注释的很详细，若有不明白的，参考原始教程：

package com.example.smarthome;

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.MapView;
import com.baidu.platform.comapi.basestruct.GeoPoint;

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

public class MainActivity extends Activity{

	private static final String strKey = "7mKRrGFcZw6PPhewCjRZqZGQ";
	 private Toast mToast;
	//百度地图的三个重要元素
	private BMapManager   mBMapMan = null;
	private MapView       mMapView = null;
	private MapController mMapCon  = null;
	
	//MKMapViewListener 用于处理地图事件回调
	private MKMapViewListener mMapListener = null; 
	
	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		
		//创建MapManager一定要在 setcontentView之前
		mBMapMan = new BMapManager(getApplication());
		mBMapMan.init(strKey, new MyGeneralListener());

		setContentView(R.layout.activity_main);
		
		mMapView = (MapView) findViewById(R.id.bmapView);
		
		initMap();
		
		double cLat = 32.044382;
		double cLon = 118.828688;
		moveToPoint(cLat, cLon);
	}
	
	/**
	 * 将地图移到指定位置，此函数只是显示的中心位置，并非精确到某个定位点
	 */
	private void moveToPoint(double cLat ,double cLon){
        /**
         * 将地图移动至指定点
         * 使用百度经纬度坐标，可以通过http://api.map.baidu.com/lbsapi/getpoint/index.html查询地理坐标
         * 如果需要在百度地图上显示使用其他坐标系统的位置，请发邮件至mapapi@baidu.com申请坐标转换接口
         */
		
		GeoPoint p = new GeoPoint((int)(cLat * 1E6),(int)(cLon * 1E6));
		mMapCon.setCenter(p);
	}
	
	/**
	 * 在布局文件被载入之后，初始化地图
	 */
	private void initMap(){
		//根据mapView获取 mapController，这些都是地图编程必须的
		mMapCon = mMapView.getController();
		
		mMapCon.enableClick(true);		//设置地图响应点击事件
		mMapCon.setZoom(12);			//设置地图缩放级别为12
		//显示内置的缩放控件
		mMapView.setBuiltInZoomControls(true);
	}
	
	// 常用事件监听，用来处理通常的网络错误，授权验证错误等
     class MyGeneralListener implements MKGeneralListener {
        
        @Override
        public void onGetNetworkState(int iError) {
            if (iError == MKEvent.ERROR_NETWORK_CONNECT) {
            	showToast("网络错误");
            }
            else if (iError == MKEvent.ERROR_NETWORK_DATA) {
            	showToast("请输入正确的检索条件");
            }
            // ...
        }

        @Override
        public void onGetPermissionState(int iError) {
        	//非零值表示key验证未通过
            if (iError != 0) {
                //授权Key错误：
            	showToast("授权Key错误");
            }
            else{
            	showToast("key认证成功"); 
            }
        }
    }
    
    //显示toast
	public 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.对于MapManager，是

mBMapMan = new BMapManager(getApplication());

而原始教程是：

 mBMapManager = new BMapManager(this);  

笔者没有明白原因，若有知道的朋友，希望能告知，我猜想可能是Android  版本的问题，笔者采用的是Android4.1

2.AndroidManifest.xml设置问题，采用原始教程的权限设置是一直出错的，这个应该也是Android版本的问题

运行结果：