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

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

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


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

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


一 申请API

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

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

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


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

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

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

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

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

二.下载百度API的库

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


三.在项目中添加

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

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

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

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版本的问题


运行结果:

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



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

上一篇:AddressMapping -- 非常实用的地址匹配工具


下一篇:小程序获取云数据库集合的数据并显示在页面