一步步教你用Android Google Map（一）

        Android操作系统平台很容易跟Google其他应用如Google地图的整合。在Android应用中，如果能在其中加入Google地图，则会为你的应用增添强大的功能，目前不少LBS应用(基于地理位置的应用)就是充分将移动跟地图结合起来。在本文中，将一步步教你如何将Google地图结合到你的Android应用中。         

 

 

　　第一步：安装Google Map API

　　在默认情况下，在安装Google Android SDK时，是不需要必须安装Google Map API的。但要做Map应用的话，就必须安装Google Map API。我们可以通过启动Android SDK and AVD Manager这个SDK管理器去下载安装Google Map API。在启动SDK管理器后，选择“Installed Options”，去查看你已经安装了哪些SDK和是否已经安装Google Map API，如果尚未安装的话，可以在“Available Packages”中查找并下载安装，如下图所示:

▲

　　第二步：建立Eclipse 工程

　　当下载完Google API后，就可以开始新建Eclipse工程了，我们把这个工程命名为

　　AndroidGoogleMapsProject，如下图，注意必须在Build Target中勾选Google API,

　　而Application name和Package name的填写如上图所示。

 　　第三步：获得Google Map API Key

　　在正式使用Google Map API前，必须先生成Google Map API KEY。具体的详细步骤请参考<Obtaining a Maps API Key >一文

　　(http://code.google.com/intl/zh-CN/android/add-ons/google-apis/mapkey.html)，下面概括了其要点如下。

　　首先，我们要使用Java下的keytool工具，产生MD5密纹，这个是跟你的证书所关联的，在使用Google Map API时进行对证书校验。

　　Keytool这个文件一般位于%JAVA_HOME%/bin目录下，如果是Linux系统，则位于

　　$JAVA_HOME/bin下的，比如windows下在C:\programs\Java\jdk1.6.0_18\bin下。

　　在开发Android程序时，一般是在debug调试模式下开发的，这时SDK的build tools会自动使用debug模式下的证书对应用进行签名的，为了产生debug模式下证书的MD5密纹，我们必须找到debug模式下的keystore密钥库，在不同的操作系统中，keystore位于如下位置：

　　· Windows Vista: C: \ Users \\ .android \ debug.keystore

· Windows XP: C: \ Documents  and  Settings \\ .android \ debug.keystore

· OS X  and  Linux: ~ / .android / debug.keystore

　　接下来，我们开始使用keytool工具产生md5密纹，命令行下输入如下语句：

　　%JAVA_HOME% / bin / keytool  - list  - alias androiddebugkey  - keystore debug.keystore  - storepass android  - keypass android

 

现在我们就产生了debug模式下的MD5密纹了，要注意的是，你必须重新为生产环境下的应用重新生成一次MD5密纹，因为如果在不同的Android SDK或者不同的开发环境下，MD5密纹是不同的，否则换了环境的话Google Map将不会工作。

 

 

 

　　产生的MD5密纹的输出如下面：

　　androiddebugkey, Apr  2 ,  2010 , PrivateKeyEntry,

Certificate fingerprint (MD5):  72 :BF: 25 :C1:AF:4C:C1:2F: 34 :D9:B1: 90 : 35 :XX:XX:XX

　　接下来，我们要到Google Map API的主页去申请一个Map的key了，可以访问

　　http://code.google.com/android/maps-api-signup.html页面，在其中的MD5 fingerprint一栏中输入刚才生成的MD5密纹，如下图：

　　输入后，点Generate API Key，之后会为我们产生Google Map API了，如下图，这个API是我们在程序中可以使用的。

　　其中还给出了如何在android中使用该API的方法。
 

　　第四步：开始创建Android Google Map应用

　　其实，编写Android Map应用并不复杂，只需要继承MapActivity类就可以了。MapView这个类功能是从Google　Map地图中获得数据并且展示地图。MapActivity的主要功能有：

　　1) 管理Activity的生命周期

　　2) 为MapView类建立和撤消相关的服务。

　　在继承了MapActivity类后，我们要实现其中的isRouteDisplayed方法，这个方法其实是用来表示我们是否显示一些路线的信息，这个通常用在地图的飞行模式时才使用，这里我们不提供任何信息仅是返回false即可。

　　在我们的activity中，我们将引用到MapView,它是在界面xml中定义的。同时我们也用到setBuiltInZoomControls方法设置地图允许缩放模式。

　　初步的代码是这样的：

package com.javacodegeeks.android.googlemaps;

import android.os.Bundle;

import com.google.android.maps.MapActivity;
import com.google.android.maps.MapView;

public  class GMapsActivity extends MapActivity {
    
     private  MapView mapView;
    
    @Override
     public  void onCreate(Bundle savedInstanceState) {
        
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        mapView  =  (MapView) findViewById(R.id.map_view);       
        mapView.setBuiltInZoomControls( true );
        
    }

    @Override
    protected  boolean  isRouteDisplayed() {
        return  false ;
    }
    
}
而相应的界面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
  xmlns:android = " http://schemas.android.com/apk/res/android "
  android:id = " @+id/map_view "
  android:layout_width = " fill_parent "  
  android:layout_height = " fill_parent "
  android:clickable = " true "  
  android:enabled = " true "  
  android:apiKey = " API-KEY-HERE "   />
   
</ RelativeLayout >

 

　　注意，其中要把你获得的Google Map的API KEY写到MapView控件中去。最后，记得在AndroidManifest.xml配置文件中，加上对Internet和Map的使用访问权限，其中由于Google Map的API是另外提供的API，因此也需要使用use-library标签进行说明，如下代码所示。

< ?xml version = " 1.0 "  encoding = " utf-8 " ? >

< manifest xmlns:android = " http://schemas.android.com/apk/res/android "
      package = " com.javacodegeeks.android.googlemaps "
      android:versionCode = " 1 "
      android:versionName = " 1.0 " >
      
     < application android:icon = " @drawable/icon "  android:label = " @string/app_name " >
    
         < activity android:name = " .GMapsActivity "
                  android:label = " @string/app_name " >
             < intent - filter >
                 < action android:name = " android.intent.action.MAIN "   />
                 < category android:name = " android.intent.category.LAUNCHER "   />
             </ intent - filter >
         </ activity >
        
       < uses - library android:name = " com.google.android.maps "   />
      
     </ application >

     < uses - permission android:name = " android.permission.INTERNET " />

</ manifest >  

　　运行程序，可以得到一个初步的地图，如下图所示：