Android Google Map API 开发基础知识

开发基于谷歌地图的应用和普通的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"/>

可能还需要添加其他权限。

例如：

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;
}
}
}