android手机地图开发流程基础

今天看到了某网站上的一个仅3万元的手机地图显示系统的开发项目，心动之余只恨自己当时没有好好的学好手机地图开发，现在将android手机地图开发的流程温习一遍。

一、注册 Android 地图 API 密钥

运行：keytool -list -keystore ~/.android/debug.keystore

用得到的MD5码到http://code.google.com/intl/zh-CN/android/maps-api-signup.html注册API密钥。

注册完成后会得到如下的网页：

您的密钥是：

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

此密钥适用于所有使用以下指纹所对应证书进行验证的应用程序：

XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX:XX

下面是一个 xml 格式的示例，帮助您了解地图功能：

android:layout_width="fill_parent"
android:layout_height="fill_parent"

android:apiKey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
/>

二、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，所以必须添加

由于需要从网络获取地图数据，所以需要访问网络的权限

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

例如：

AndroidManifest.xml                                                                                               

3.创建MapView

要显示地图，需要创建一个MapView，在Xml文件中的布局如下。其中的android：apiKey的值就是我们第一步申请的Key了。

main.xml  

当然，可以在程序中通过如下代码来创建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.javaimport 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 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;        }    }}