相信对于每个IT人士来说,android的编程大家并不陌生。简单的编程方法这里不赘述。
笔者在实际应用中,运用到百度地图的相关编程,之所以选择百度而不选择谷歌地图,这个大家都懂的。
查阅了很多资料,尤其是这篇文章给我的收获较大:http://blog.csdn.net/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版本的问题
运行结果: