Android调用Google Map

Google为android的开发者提供了一套相当完善的地图应用接口，开发者可以很方便的使用这些接口来做一些LBS应用程序。 

我所使用的开发环境是eclipse,另外再用ADT工具安装Google Maps library组件（这个库是Google APIs add-on的一部分，要确保开发环境里已经安装了这个库）。 

具体调用 google map 的流程为：网上申请Maps API Key=>创建一个MapActivity=>在地图上添加自定义图层 

一.如何获得Maps API Key？

1.在命令行里用keytool命令生成一个MD5 certificate fingerprint 

$ keytool -list -alias alias_name -keystore my-release-key.keystore

根据提示输入密码等信息，然后可以得到如下MD5 certificate fingerprint   

Certificate fingerprint (MD5): 94:1E:43:49:87:73:BB:E6:A6:88:D7:20:F1:8E:B5:98

只有获得了这个MD5 certificate fingerprint才可以在注册页面获取key.

2.注册Maps API Key

打开http://code.google. com/android/maps-api-signup.html 

在这个页面输入你的MD5 certificate fingerprint就可以获取Maps API Key.这里我们得到的key为   

08dkmLW5o********PgzGDxT9mb1JKOoV3Rhrlw

二、创建一个MapActivity

1.在eclipse中创建一个名字为HelloGoogleMaps的android工程。因为我们要调用地图API，所以在选择Build Target的时候一定要选择Google APIs。

2.编辑XML文件。

mail.xml 

<?xml version="1.0" encoding="utf-8"?>  
<com.google.android.maps.MapView  
    xmlns:android="http://schemas.android.com/apk/res/android"  
    android:id="@+id/mapview"  
    android:layout_width="fill_parent"  
    android:layout_height="fill_parent"  
    android:clickable="true"  
    android:apiKey="08dkmLW5o********PgzGDxT9mb1JKOoV3Rhrlw"  
/> 

  

android:apiKey即是我们刚才申请得到的Maps Key,这里一定不能出错，否则可能会无法得到map tiles。

3.修改AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>  
<manifest xmlns:android="http://schemas.android.com/apk/res/android"  
      package="com.HelloGoogleMaps"  
      android:versionCode="1"  
      android:versionName="1.0">  
        
    <uses-permission android:name="android.permission.INTERNET" />  
          
    <application android:icon="@drawable/icon" android:label="@string/app_name">   
        <activity android:name=".HelloGoogleMaps"    
                  android:theme="@android:style/Theme.NoTitleBar"  
                  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-sdk android:minSdkVersion="8" />  
  
</manifest>  

因为map tiles来自于google map server，所以我们需要加上

<uses-permission android:name="android.permission.INTERNET" /> 让application可以访问internet.

另外再application标签下面需要添加<uses-library android:name="com.google.android.maps" /> 指明我们要用到google map的library。

4.创建一个继承自MapActivity的类。

    package com.HelloGoogleMaps;  
      
    import android.os.Bundle;  
    import com.google.android.maps.MapActivity;  
    import com.google.android.maps.MapView;  
      
    public class HelloGoogleMaps extends MapActivity {  
        /** Called when the activity is first created. */  
        @Override  
        public void onCreate(Bundle savedInstanceState) {  
            super.onCreate(savedInstanceState);  
            setContentView(R.layout.main);  
              
            MapView mapView = (MapView) findViewById(R.id.mapview);  
            mapView.setBuiltInZoomControls(true);  
        }  
      
        @Override  
        protected boolean isRouteDisplayed() {  
            // TODO Auto-generated method stub  
            return false;  
        }  
    }  

完成了以上步骤，运行程序就可以看到自己的activity可以显示google map了。

 

三、添加自定义图层

我们调用google map的目的是为了在map上面显示自己想显示的内容，比如显示用户当前的位置（需要调用GPS） ，或是将某一个兴趣点（Point Of Interest）在地图上显示出来等。这样就需要在google map上面添加自定义的图层了。 

1.创建一个继承自ItemizedOverlay的class 

    import java.util.ArrayList;  
      
    import android.app.AlertDialog;  
    import android.content.Context;  
    import android.graphics.drawable.Drawable;  
      
    import com.google.android.maps.ItemizedOverlay;  
    import com.google.android.maps.OverlayItem;  
      
    public class ZPoiItem extends ItemizedOverlay {  
          
        private ArrayList<OverlayItem> mOverlays = new ArrayList<OverlayItem>();  
        private Context mContext;  
          
        public ZPoiItem(Drawable defaultMarker) {  
            super(boundCenterBottom(defaultMarker));  
        }  
        public ZPoiItem(Drawable defaultMarker, Context context) {  
            super(defaultMarker);  
            mContext = context;  
        }  
          
        public void addOverlay(OverlayItem overlay) {  
            mOverlays.add(overlay);  
            populate();  
        }  
          
        @Override  
        protected OverlayItem createItem(int i) {  
            // TODO Auto-generated method stub  
            return mOverlays.get(i);  
      
        }  
      
        @Override  
        public int size() {  
            // TODO Auto-generated method stub  
            return mOverlays.size();  
        }  
      
        @Override  
        protected boolean onTap(int index) {  
    //    OverlayItem item = mOverlays.get(0);//OverlayItem item = mOverlays.get(index);  
    //    AlertDialog.Builder dialog = new AlertDialog.Builder(mContext);  
    //    dialog.setTitle(item.getTitle());  
    //    dialog.setMessage(item.getSnippet());  
    //    dialog.show();  
          return true;  
        }  
    }  

创建好了ZPoiItem类，回到HelloGoogleMaps类，添加变量

private MapController mMapController 

该变量用于控制地图的，比如设置地图中心点，设置地图比例尺等。

然后在onCreate函数的末尾添加如下代码：

    mMapController = mapView.getController();  
      
    List<Overlay> mapOverlays = mapView.getOverlays();  
            Drawable drawable = this.getResources().getDrawable(R.drawable.star_big_on);//star_big_on is an icon id.  
            ZPoiItem itemizedoverlay = new ZPoiItem(drawable);  
      
            GeoPoint point = new GeoPoint(1288515,103853388); //a poi in Singapore      
            mMapController.setCenter(point);//set map center   
            mMapController.setZoom(12);//set map scale  
            mMapController.animateTo(point);  
              
            OverlayItem overlayitem = new OverlayItem(KeywordSearchResultActivity.mSelPoint, "Hola, Mundo!", "I'm in Mexico City!");  
            itemizedoverlay.addOverlay(overlayitem);  
            mapOverlays.add(itemizedoverlay);  

至此已完成了在google map上添加自定义图层。效果图如下：

 

后 记：值得一提的是，android的map软件需要签名以后才能发布给其他手机，这个签名过程用eclipse的GUI可以很方便的完成，右键工程根目录 选择Android Tools->Export signed application package...，进入签名设置界面，根据提示一步步完成签名。用签好名的.apk安装到手机里可以看到如上所示的结果。Google map的API非常丰富，开发者可以利用这些函数接口编写各种各样的LBS软件或是其他基于地图的应用软件。Foursuqare就是一个不错的调用 google map的LBS软件。