开发基于谷歌地图的应用和普通的android应用差不多都要使用它提供给我们的类库,所不同的是google map的类库不是android平台的基本类库,是google api的一部分,所以建立项目时,SDK要选择Google APIs;
还有一点,开发基于地图的应用时候需要使用google map的APIkey,必须先申请key,然后才能开发基于地图的应用。
下边分步骤记录下,整个过程:
一、申请google Maps API key(用于开发和debug)
为了能顺利的申请Android Map API Key,必须要准备google的账号和系统的证明书。一般Google发布Key都需要Google账号,Google账号是通用的,Gmail的账号就可以。当一个程序发布时必须要证明书,证明书其实就是MD5.我们这里并不是发布,而只是为了开发测试,可以使用Debug版的证明书,下面我们就来学习如何申请Debug版的Key:
1.找到你的debug.keystore文件
在Eclipse工具下,选择windows-->Preference-->Android-->Build,其中Default debug keystore的值便是debug.keystore的路径了。
2.取得debug.keystore的MD5值
首先cmd命令行进入debug.keystore文件所在的路径,执行命令:keytool -list -keystore debug.keystore,这时可能会提示你输入密码,这里默认的密码是“android",这样即可取得MD5值。
3.申请Android Map 的API Key.
打开浏览器,输入网址:http://code.google.com/android/maps-api-signup.html,填入你的认证指纹(MD5)即可获得apiKey了,结果显示如下:
感谢您注册 Android 地图 API 密钥!
您的密钥是:
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
我IE打开的时候是乱码,不知道是不是自己电脑有问题。后来改用了chrome就正常显示了。
到此,我们就完成了API Key的申请了,记录下Key值,在后续开发中使用。(放在layout中加入的MapView中)
二.Google Map API的使用
Android中定义了一个名为com.google.android.map的包,其中包含了一系列用于在google map上显示、控制和叠层信息的功能类,以下是该包中最重要的几个类:
1.MapActivity:这个类是用于显示Google Map的Activity类,它需要连接底层网络。MapActivity是一个抽象类,任何想要显示MapView的activity都需要派生自MapActivity,并且在其派生类的onCreate()中,都要创建一个MapView实例。
2.MapView:MapView是用于显示地图的View组件。它派生自android.view.ViewGroup。它必须和MapActivity配合使用,而且只能被MapActivity创建,这是因为MapView需要通过后台的线程来连接网络或者文件系统,而这些线程需要有MapActivity来管理。
3.MapController:MapController用于控制地图的移动、缩放等。
4.OverLay:这是一个可显示于地图之上的可绘制的对象。
5.GeoPoint:这是一个包含经纬度位置的对象。
三.实例开发
1.创建工程,注意SDK旋转为"Goolge APIs”
2.修改AndroidManifest.xml文件
由于使用Google Map API,所以必须添加<uses-library android:name="com.google.android.maps" />
由于需要从网络获取地图数据,所以需要访问网络的权限<uses-permission android:name="android.permission.INTERNET"/>
可能还需要添加其他权限。
例如:
AndroidManifest.xml
<?
xml version
=
"
1.0
"
encoding
=
"
utf-8
"
?>
<
manifest xmlns:android
=
"
http://schemas.android.com/apk/res/android
"
package
=
"
com.yarin.android.Examples_09_03
"
android:versionCode
=
"
1
"
android:versionName
=
"
1.0
"
>
<
application android:icon
=
"
@drawable/icon
"
android:label
=
"
@string/app_name
"
>
<
uses
-
library android:name
=
"
com.google.android.maps
"
/>
<
activity android:name
=
"
.Activity01
"
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.INTERNET
"
/>
<
uses
-
sdk android:minSdkVersion
=
"
5
"
/>
</
manifest
>
3.创建MapView
要显示地图,需要创建一个MapView,在Xml文件中的布局如下。其中的android:apiKey的值就是我们第一步申请的Key了。
main.xml
<?
xml version
=
"
1.0
"
encoding
=
"
utf-8
"
?>
<
RelativeLayout xmlns:android
=
"
http://schemas.android.com/apk/res/android
"
android:layout_width
=
"
fill_parent
"
android:layout_height
=
"
fill_parent
"
>
<
com.google.android.maps.MapView android:id
=
"
@+id/MapView01
"
android:layout_width
=
"
fill_parent
"
android:layout_height
=
"
fill_parent
"
android:apiKey
=
"
0AubmfALdupLSlQkE67OTXgcQgWtyhXcO7uhsIQ
"
/>
</
RelativeLayout
>
当然,可以在程序中通过如下代码来创建MapView:
MapView map = new MapView( this, "(android maps api key)");
4.实现MapActivity
MapView需要由MapActivity来管理,所以程序部分应该继承自MapActivity类,必须实现isRouteDisplay方法。
MapView提供了3中模式的地图,分别可以通过以下方式设置采用什么模式来显示地图。
mMapView.setTraffic(true); //设置为交通模式
mMapView.setSatellite(true); //设置为卫星模式//
mMapView.setStreetView(false); //设置为街景模式
通过setBuiltZoomControls方法设置地图是否支持缩放。
5.MapController的使用
如果需要设置地图显示的地点以及放大倍数等,就需要使用MapController来控制地图。可以通过如下代码获得MapController对象:
mMapController = mMapView.getController();
要定位地点,需要构造一个GeoPoint来表示地点的经纬度,然后使用animateTo方法将地图定位到指定的GeoPoint上,代码如下:
//
设置起点为成都
mGeoPoint
=
new
GeoPoint((
int
) (
30.659259
*
1000000
), (
int
) (
104.065762
*
1000000
));
//
定位到成都
mMapController.animateTo(mGeoPoint);
复制代码
6.Ovelay的使用
如果需要在地图上标注一些图标文字等信息,就需要使用Overlay。这里我们首先要将地图上的经度和纬度转换成屏幕上的实际坐标,才能将信息绘制上去。Map API中提供了Projection.toPixels(GeoPoint in,GeoPoint out)方法,可以将经度和纬度转换成屏幕上的坐标。
首先需要实现OverLay中的draw方法才能在地图上绘制信息,代码如下:
class
MyLocationOverlay
extends
Overlay { @Override
public
boolean
draw(Canvas canvas, MapView mapView,
boolean
shadow,
long
when) { ........ } }
复制代码
综合上面的代码如下
Activity01.java
import
java.util.List;
import
android.graphics.Bitmap;
import
android.graphics.BitmapFactory;
import
android.graphics.Canvas;
import
android.graphics.Paint;
import
android.graphics.Point;
import
android.os.Bundle;
import
com.google.android.maps.GeoPoint;
import
com.google.android.maps.MapActivity;
import
com.google.android.maps.MapController;
import
com.google.android.maps.MapView;
import
com.google.android.maps.Overlay;
public
class
Activity01
extends
MapActivity {
private
MapView mMapView;
private
MapController mMapController;
private
GeoPoint mGeoPoint;
/**
Called when the activity is first created.
*/
@Override
public
void
onCreate(Bundle savedInstanceState) {
super
.onCreate(savedInstanceState); setContentView(R.layout.main); mMapView
=
(MapView) findViewById(R.id.MapView01);
//
设置为交通模式
//
mMapView.setTraffic(true);
//
设置为卫星模式
//
mMapView.setSatellite(true);
//
设置为街景模式
mMapView.setStreetView(
false
);
//
取得MapController对象(控制MapView)
mMapController
=
mMapView.getController(); mMapView.setEnabled(
true
); mMapView.setClickable(
true
);
//
设置地图支持缩放
mMapView.setBuiltInZoomControls(
true
);
//
设置起点为成都
mGeoPoint
=
new
GeoPoint((
int
) (
30.659259
*
1000000
), (
int
) (
104.065762
*
1000000
));
//
定位到成都
mMapController.animateTo(mGeoPoint);
//
设置倍数(1-21)
mMapController.setZoom(
15
);
//
添加Overlay,用于显示标注信息
MyLocationOverlay myLocationOverlay
=
new
MyLocationOverlay(); List
<
Overlay
>
list
=
mMapView.getOverlays(); list.add(myLocationOverlay); }
protected
boolean
isRouteDisplayed() {
return
false
; }
class
MyLocationOverlay
extends
Overlay { @Override
public
boolean
draw(Canvas canvas, MapView mapView,
boolean
shadow,
long
when) {
super
.draw(canvas, mapView, shadow); Paint paint
=
new
Paint(); Point myScreenCoords
=
new
Point();
//
将经纬度转换成实际屏幕坐标
mapView.getProjection().toPixels(mGeoPoint, myScreenCoords); paint.setStrokeWidth(
1
); paint.setARGB(
255
,
255
,
0
,
0
); paint.setStyle(Paint.Style.STROKE); Bitmap bmp
=
BitmapFactory.decodeResource(getResources(), R.drawable.home); canvas.drawBitmap(bmp, myScreenCoords.x, myScreenCoords.y, paint); canvas.drawText(
"
天府广场
"
, myScreenCoords.x, myScreenCoords.y, paint);
return
true
; } } }
复制代码