学步园

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"?><br /> <com.google.android.maps.MapView<br /> xmlns:android="http://schemas.android.com/apk/res/android"<br /> android:id="@+id/mapview"<br /> android:layout_width="fill_parent"<br /> android:layout_height="fill_parent"<br /> android:clickable="true"<br /> android:apiKey="08dkmLW5o********PgzGDxT9mb1JKOoV3Rhrlw"<br /> /><br />   

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

3.修改AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?><br /> <manifest xmlns:android="http://schemas.android.com/apk/res/android"<br /> package="com.HelloGoogleMaps"<br /> android:versionCode="1"<br /> android:versionName="1.0"></p> <p> <uses-permission android:name="android.permission.INTERNET" /></p> <p> <application android:icon="@drawable/icon" android:label="@string/app_name"><br /> <activity android:name=".HelloGoogleMaps"<br /> android:theme="@android:style/Theme.NoTitleBar"<br /> android:label="@string/app_name"><br /> <intent-filter><br /> <action android:name="android.intent.action.MAIN" /><br /> <category android:name="android.intent.category.LAUNCHER" /><br /> </intent-filter><br /> </activity><br /> <uses-library android:name="com.google.android.maps" /><br /> </application> </p> <p> <uses-sdk android:minSdkVersion="8" /></p> <p></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;</p> <p>import android.os.Bundle;<br /> import com.google.android.maps.MapActivity;<br /> import com.google.android.maps.MapView;</p> <p>public class HelloGoogleMaps extends MapActivity {<br /> /** Called when the activity is first created. */<br /> @Override<br /> public void onCreate(Bundle savedInstanceState) {<br /> super.onCreate(savedInstanceState);<br /> setContentView(R.layout.main);</p> <p> MapView mapView = (MapView) findViewById(R.id.mapview);<br /> mapView.setBuiltInZoomControls(true);<br /> }</p> <p> @Override<br /> protected boolean isRouteDisplayed() {<br /> // TODO Auto-generated method stub<br /> return false;<br /> }<br /> }

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

三、添加自定义图层

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

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

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

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

private MapController mMapController</p> <p>

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

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

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

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

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