最近自己想研究下地图,本来想研究google Map,但是申请API key比较坑爹,于是从百度地图入手,其实他们的用法都差不多,本篇文章就带领大家在自己的Android项目中加入百度地图的功能,接下来我会写一系列关于百度地图的文章,欢迎大家到时候关注!
一申请API key
?在使用百度地图之前,我们必须去申请一个百度地图的API key,申请地址https://www.doczj.com/doc/0e11977134.html,/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.baidu mapdemo 这样子我们就配置好了API key
二、下载百度地图API库
要在Android应用中使用百度地图API,就需要在工程中引用百度地图API开发包,下载地址https://www.doczj.com/doc/0e11977134.html,/map/sdkandev-download.htm,下载Android SDKv2.1.3 lib库就行了
三、在Android项目中引用百度地图
新建Android项目 BaiduMapDemo,然后将百度地图API库加入工程,如下图
?在布局文件中添加百度地图控件,
[html]view plaincopy
1.
2. 3.android:layout_width="fill_parent" 4.android:layout_height="fill_parent" 5.android:orientation="vertical"> 6. 7. 8.android:id="@+id/bmapView" 9.android:layout_width="fill_parent" 10.android:layout_height="fill_parent" 11.android:clickable="true"/> 12. 13.
?Activity界面代码,注释的很详细,相信你看得懂
[java]view plaincopy
1.package com.example.baidumapdemo;
2.
3.import android.app.Activity;
4.import android.graphics.Bitmap;
5.import android.os.Bundle;
6.import android.widget.Toast;
7.
8.import com.baidu.mapapi.BMapManager;
9.import com.baidu.mapapi.MKGeneralListener;
10.import com.baidu.mapapi.map.MKEvent;
11.import com.baidu.mapapi.map.MKMapViewListener;
12.import com.baidu.mapapi.map.MapController;
13.import com.baidu.mapapi.map.MapPoi;
14.import com.baidu.mapapi.map.MapView;
15.import https://www.doczj.com/doc/0e11977134.html,api.basestruct.GeoPoint;
16.
17.public class MainActivity extends Activity {
18.private Toast mToast;
19.private BMapManager mBMapManager;
20./**
21. * MapView 是地图主控件
22. */
23.private MapView mMapView = null;
24./**
25. * 用MapController完成地图控制
26. */
27.private MapController mMapController = null;
28./**
29. * MKMapViewListener 用于处理地图事件回调
30. */
31. MKMapViewListener mMapListener = null;
32.
33.@Override
34.protected void onCreate(Bundle savedInstanceState) {
35.super.onCreate(savedInstanceState);
36./**
37. * 使用地图sdk前需先初始化BMapManager,这个必须在setContentView()先初始化
38. */
39. mBMapManager = new BMapManager(this);
40.
41.//第一个参数是API key,
42.//第二个参数是常用事件监听,用来处理通常的网络错误,授权验证错误等,你也可以不添
加这个回调接口
43. mBMapManager.init("7ae13368159d6a513eaa7a17b9413b4b", new MKGeneralListen
er() {
45.//授权错误的时候调用的回调函数
46.@Override
47.public void onGetPermissionState(int iError) {
48.if (iError == MKEvent.ERROR_PERMISSION_DENIED) {
49. showToast("API KEY错误, 请检查!");
50. }
51. }
52.
53.//一些网络状态的错误处理回调函数
54.@Override
55.public void onGetNetworkState(int iError) {
56.if (iError == MKEvent.ERROR_NETWORK_CONNECT) {
57. Toast.makeText(getApplication(), "您的网络出错啦!
", Toast.LENGTH_LONG).show();
58. }
59. }
60. });
61.
62.
63. setContentView(https://www.doczj.com/doc/0e11977134.html,yout.activity_main);
64.
65. mMapView = (MapView) findViewById(R.id.bmapView);
66.
67./**
68. * 获取地图控制器
69. */
70. mMapController = mMapView.getController();
71./**
72. * 设置地图是否响应点击事件 .
73. */
74. mMapController.enableClick(true);
75./**
76. * 设置地图缩放级别
77. */
78. mMapController.setZoom(12);
79.
80./**
81. * 显示内置缩放控件
82. */
83. mMapView.setBuiltInZoomControls(true);
84.
85./**
86. * 保存精度和纬度的类,
88. GeoPoint p = new GeoPoint((int)(22.547923 * 1E6), (int)(114.067368 * 1E6)
);
89.//设置p地方为中心点
90. mMapController.setCenter(p);
91. mMapView.regMapViewListener(mBMapManager, new MKMapViewListener() {
92.
93./**
94. * 地图移动完成时会回调此接口方法
95. */
96.@Override
97.public void onMapMoveFinish() {
98. showToast("地图移动完毕!");
99. }
100.
101./**
102. * 地图加载完毕回调此接口方法
103. */
104.@Override
105.public void onMapLoadFinish() {
106. showToast("地图载入完毕!");
107. }
108.
109./**
110. * 地图完成带动画的操作(如: animationTo())后,此回调被触发
111. */
112.@Override
113.public void onMapAnimationFinish() {
114.
115. }
116.
117./**
118. * 当调用过 mMapView.getCurrentMap()后,此回调会被触发
119. * 可在此保存截图至存储设备
120. */
121.@Override
122.public void onGetCurrentMap(Bitmap arg0) {
123.
124. }
125.
126./**
127. * 点击地图上被标记的点回调此方法
128. *
129. */
130.@Override
131.public void onClickMapPoi(MapPoi arg0) {
132.if (arg0 != null){
133. showToast(arg0.strText);
134. }
135. }
136. });
137. }
138.
139.
140.
141.@Override
142.protected void onResume() {
143.//MapView的生命周期与Activity同步,当activity挂起时需调用MapView.onPause()
144. mMapView.onResume();
145.super.onResume();
146. }
147.
148.
149.
150.@Override
151.protected void onPause() {
152.//MapView的生命周期与Activity同步,当activity挂起时需调用MapView.onPause()
153. mMapView.onPause();
154.super.onPause();
155. }
156.
157.@Override
158.protected void onDestroy() {
159.//MapView的生命周期与Activity同步,当activity销毁时需调用MapView.destroy()
160. mMapView.destroy();
161.
162.//退出应用调用BMapManager的destroy()方法
163.if(mBMapManager != null){
164. mBMapManager.destroy();
165. mBMapManager = null;
166. }
167.
168.super.onDestroy();
169. }
170.
171.
172.
173./**
174. * 显示Toast消息
175. * @param msg
176. */
177.private void showToast(String msg){
178.if(mToast == null){
179. mToast = Toast.makeText(this, msg, Toast.LENGTH_SHORT);
180. }else{
181. mToast.setText(msg);
182. mToast.setDuration(Toast.LENGTH_SHORT);
183. }
184. mToast.show();
185. }
186.
187.
188.}
1. BMapManager是地图的引擎类,这个必须在setContentView方法之前被实例化,我
们需要使用其方法init(String strKey,MKGeneralListener listener)来加入API key,MKGeneralListener 该接口返回网络状态,授权验证等结果,我们需要实现该接口以
处理相应事件
2. MapView就是我们的地图控件了,MapView有和Activity同步的生命周期,例如
onResume() ,onPause() ,onRestoreInstanceState(Bundle state) ,destroy()等,我们可以通过getController()方法获取地图控制器MapController,这个对象可用于控制和驱动平移和缩放等
3. MapView有两个接口可以注册,分别是MKMapTouchListener(地图点击事件监听器),
MKMapViewListener(地图监听器)上面的Demo我给MapView注册了
MKMapViewListener,也简单实现了里面的几个方法,接下来我会带着大家详细的了
解这里面的方法,希望大家到时候关注我的博客
当然,我们在程序运行之前,还必须加入相对于的权限
[html]view plaincopy
1.
2.
3.
4.
5.
6.
7.
运行结果
好了,结束了.此篇文章是转载的csdn的一篇博客,谢谢原博主吧