Android Google Map API 开发基础知识

 一、申请google Maps API 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.需要google帐号

打开浏览器，输入网址：http://code.google.com/android/maps-api-signup.html

填入你的认证指纹(MD5)即可获得apiKey，记录下值

二.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.yan.map"
      android:versionCode="1"
      android:versionName="1.0">
    <uses-sdk android:minSdkVersion="8" />

    <application android:icon="@drawable/icon" android:label="@string/app_name">
       <uses-library android:name="com.google.android.maps" />
        <activity android:name=".Google_mapActivity"
                  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-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
       <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
       <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" />
    
</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:orientation="vertical"
    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=" 申请到的google apikey"
                 />
<LinearLayout
    android:id="@+id/zoomview"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_alignBottom="@+id/mapView01"
    android:layout_centerHorizontal="true"
    />
</RelativeLayout>

4.实现MapActivity

MapView需要由MapActivity来管理，所以程序部分应该继承自MapActivity类，必须实现isRouteDisplay方法。

MapView提供了3中模式的地图，分别可以通过以下方式设置采用什么模式来显示地图。

      mMapView.setTraffic(true); //设置为交通模式 

      mMapView.setSatellite(true); //设置为卫星模式//

     mMapView.setStreetView(false)； //设置为街景模式

通过setBuiltZoomControls方法设置地图是否支持缩放。

package com.yan.map;

import java.util.List;

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;

import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.graphics.Canvas;
import android.graphics.Paint;
import android.graphics.Point;
import android.os.Bundle;


public class Google_mapActivity extends MapActivity {
    private MapView     mMapView;
    private MapController mMapController;
    private GeoPoint mGeoPoint;
    @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) (35.4310* 1000000), (int) (116.6240 * 1000000));
        //定位
        mMapController.animateTo(mGeoPoint);
        //设置倍数
        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.icon);
            canvas.drawBitmap(bmp, myScreenCoords.x, myScreenCoords.y, paint);
            canvas.drawText("当前位置", myScreenCoords.x, myScreenCoords.y, paint);
            return true;
        }
    }
}