Android开发百度地图(一)--显示基本地图
最近由于比赛的需要,自己学习了一下百度地图的开发。希望以下的内容能够对大家有用。
一、开发前的准备工作:
1、注册百度账号,并登录。(有百度账号的话直接登录)
2、申请Key,地址:http://developer.baidu.com/map/android-mobile-apply-key.htm
注:经研究发现在申请KEY时,应用名称一定要写成my_app_应用名(也就是说"my_app_"是必须要有的)这样,生成的API密钥后面才可用。其他格式的也可以生成API密钥,但是在使用过程中会出问题。(比如:一开始就报授权Key错误,或者使用一段时间后就不行了),当您选择使用v2.1.3及之后版本的SDK时,需要到新的Key申请页面进行全新Key的申请,申请及配置流程请参考开发指南对应章节 。(选择使用v2.1.2及之前版本SDK的开发者,申请密钥(Key)的方式不变)。 (特别注意:每一个密钥只能对应这一个android工程,如果另外建工程的话,就需要重新申请密钥)。
二、如何的申请密钥(现在的android版本基本上都是v2.1.3及之后版本的SDK,所以我这里就只说一下v2.1.3及之后版本的SDK之后的申请的密钥)
1、首先登录百度账号。
2、点击上面的申请key的地址。
点击申请新Key。进入界面之后点击创建应用按钮。如图:
安全码的获取,地址:http://developer.baidu.com/map/sdkandev-14.htm 很详细,就不说了。
然后就会获得你的密钥了,
其中 访问应用ak 就是所需要的密钥了。
三、下载SDK(v2.0.0),地址:http://developer.baidu.com/map/sdkandev-download.htm
注:下载Android SDKv2.0.0 (矢量地图版),里面有BaiduMap_AndroidSDK_v2.0.0_Lib.zip、BaiduMap_AndroidSDK_v2.0.0_Docs.zip和BaiduMap_AndroidSDK_v2.0.0_Sample.zip三个压缩包。(在下载的时候会有全部下载和一键下载,注意:请点击 一键下载)。
如图:
四、搭建开发环境,开始The world, hello(世界,你好)之旅:
1、创建android项目,在选SDK时(Choose an SDK to target),选的不是Google APIs,是不带地图服务的SDK
2、在项目创建完毕,在工程里新建libs文件夹,将开发包(BaiduMap_AndroidSDK_v2.2.0_Lib.zip)里的baidumapapi_v2_2_0.jar拷贝到libs根目录下,将libBaiduMapSDK_v2_2_0.so和liblocSDK3.so 拷贝到libs\armeabi目录下,在工程属性->Java Build Path->Libraries中选择“Add External JARs”,选定baidumapapi_vX_X_X.jar,确定后返回。
通过以上两步操作后,您就可以正常使用百度地图SDK为您提供的全部功能了。
注意:由于adt插件升级,若您使用Eclipse adt 22的话,需要对开发环境进行相应的设置,方法如下:
1. 在Eclipse 中选中工程,右键选 Properties->Java Build Path->Order and Export 使 Android Private Libraries处于勾选状态;
2. Project -> clean-> clean all . 拷贝完成后的工程目录如下图所示:
五、显示百度地图
1、在AndroidManifest.xml文件中添加使用权限:
<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" />
<!-- 读取手机的当前状态权限,没有的话会报错,这个是使用百度地图API必须的 -->
<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>
<!-- Cache功能需要读写外部存储器,若没这个权限,地图加载不出来 -->
<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" />
2、添加对多种屏幕的支持:
<supports-screens
android:anyDensity="true"
android:largeScreens="true"
android:normalScreens="false"
android:resizeable="true"
android:smallScreens="true" />
3、在布局xml文件中添加地图控件;
<com.baidu.mapapi.map.MapView
android:id="@+id/bmapView"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:clickable="true" />
4、在application中添加开发密钥 (这里的“开发者Key”是你申请的密钥)
<application
<meta-data
android:name="com.baidu.lbsapi.API_KEY"
android:value="开发者 key"/>
</application>
5、MainActivity.java的完整代码和注释 如下:
package com.example.bai;
import com.baidu.mapapi.BMapManager;
import com.baidu.mapapi.MKGeneralListener;
import com.baidu.mapapi.map.MKEvent;
import com.baidu.mapapi.map.MapController;
import com.baidu.mapapi.map.MapView;
import com.baidu.platform.comapi.basestruct.GeoPoint;
import android.os.Bundle;
import android.app.Activity;
import android.widget.Toast;
/*
* 基本的地图图层,包括若干个缩放级别,显示基本的地图信息,包括道路、街道、学校、公园等内容。
*/
public class MainActivity extends Activity {
//显示地图的View
private MapView mMapView = null;
//地图引擎管理类
private BMapManager mBMapManager = null;
/*
* 经研究发现在申请KEY时:应用名称一定要写成my_app_应用名(也就是说“my_app_”是必须有的)。
* 百度地图SDK提供的服务是免费的,接口无使用次数限制。您需要先申请密钥(key),才可使用该套SDK。
*/
public static final String keystring = "Y1Xk5WMZtPXfYLEWqBr7NqQj";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//注意:请在调用setCOntentView前初始化BManager对象,否则就会报错
mBMapManager = new BMapManager(getApplicationContext());
mBMapManager.init(keystring, new MKGeneralListener(){
@Override
public void onGetNetworkState(int arg0) {
// TODO Auto-generated method stub
if(arg0 == MKEvent.ERROR_NETWORK_CONNECT){
Toast.makeText(MainActivity.this.getApplicationContext(), "您的网络出错了",Toast.LENGTH_LONG).show();
}
}
@Override
public void onGetPermissionState(int arg0) {
// TODO Auto-generated method stub
if(arg0 == MKEvent.ERROR_PERMISSION_DENIED){
Toast.makeText(MainActivity.this.getApplicationContext(), "请在DemoApplication.java文件输入正确的授权key!", Toast.LENGTH_LONG).show();
}
}
});
setContentView(R.layout.main);
mMapView = (MapView)this.findViewById(R.id.bmapView);
//设置启用内置的缩放控件
mMapView.setBuiltInZoomControls(true);
//获取地图控制器,可以用它控制平移和缩放
MapController mMapController = mMapView.getController();
//用给定的经纬度构造一个GeoPoint,单位是微度(度 * 1E6)
//纬度值是 31.224078 经度值 121.540419
GeoPoint mGeoPoint = new GeoPoint((int) (31.224078 * 1E6),(int) (121.540419 * 1E6));
//设置地图的中心点
mMapController.setCenter(mGeoPoint);
//设置地图的缩放级别。这个值得取值范围是[3,18]。
mMapController.setZoom(13);
//当前,全国范围内已支持多个城市实时路况查询,且会陆续开通其他城市。
//在地图中显示实时交通信
mMapView.setTraffic(true);
//卫星地图是卫星拍摄的真实的地理面貌,所以卫星地图可用来检测地面的信息,你可以了解地理位置,地形等。
//显示卫星图,屏掉mMapView.setTraffic(true);这行代码。
//mMapView.setSatellite(true);
}
//重写以下方法,管理API
protected void onResume(){
mMapView.onResume();
if(mBMapManager != null){
mBMapManager.start();
}
super.onResume();
}
protected void onPause(){
mMapView.onPause();
if(mBMapManager != null){
mBMapManager.stop();
}
super.onPause();
}
protected void onDestroy(){
mMapView.destroy();
if(mBMapManager != null){
mBMapManager.destroy();
mBMapManager = null;
}
super.onDestroy();
}
}
6、效果图如下图:
这是我弄了很长时间才总结出的,希望能够对你有用。