添加Google Map到自己的工程中

使用Google API中提供的MapView库，我们可以很容易的在我们的程序中添加地图功能。

MapView库封装了Google Map的API以及用户的基本操作，所以只需一些简单的配置，就可以将Google Map完美的嵌入到工程中。

为了保证Google Map的合理应用，Google要求每个使用MapView的应用程序都必须为其MapView申请一个Maps API key。

首先，我们来获取Maps API Key。

1. 得到用来签名apk的Certificate文件，即证书文件。

     release版本的证书文件是开发人员自己生成的，这个就不用说了。

     debug版本的证书文件，用来在ADT虚拟机上发布程序，在Windows XP系统中的路径一般是C:\Documents and Settings\<user>\.android\debug.keystore。

2. 生成证书的MD5码。

     生成证书的命令是 keytool -list -keystore [证书文件]

     执行后会要求用户输入证书的密码，debug版本的证书密码是android，而release版，自己回忆去吧。。

     输入后命令将返回证书的信息，在最后一行，我们得到了证书的MD5码，例如：

       Certificate fingerprint (MD5): 28:DC:C8:F8:7E:70:C6:86:B6:F9:23:A5:2E:43:50:38

3. 打开浏览器，连接到http://code.google.com/android/maps-api-signup.html，如下图

    勾上复选框，点“Generate API Key"，好了，我们成功的注册了我们的证书，并得到了Maps API Key:

    如果忘记了API Key也没关系，重新按上述方法获取一次就可以了，两次获取的API Key值是一样的。

Key搞定了，在工程中加入MapView试试吧。

1. Layout文件 test_map.xml:

    <?xml version="1.0" encoding="utf-8"?>  
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
        android:orientation="vertical" android:layout_width="match_parent"  
        android:layout_height="match_parent">  
        <com.google.android.maps.MapView  
            android:layout_width="fill_parent"  
            android:layout_height="fill_parent"  
            android:enabled="true"  
            android:clickable="true"  
            android:apiKey="0AbLT2lwf0gC5INzAw5iLqo8fDilY1zeu80pxwA"/>  
    </LinearLayout>  

注意把android:apiKey换成你获得的Key，如果要在ADT上调试，使用debug证书对应的key，如果要发布在手机上，就要使用签名apk的证书key了。

每个证书只能对应一个Maps API Key；这个Key可以被任意个App的任意个MapView引用，只要保证引用Key的App被这个Key对应的证书签名就可以了。

如果在代码中构造MapView，需将API Key做为构造函数的参数传入，如：

mMapView = new MapView(this, "example_Maps_ApiKey_String");

2. Activity文件 TestMapActivity.java:

import com.google.android.maps.MapActivity;

public class TestMapActivity extends MapActivity {

    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.test_map);
    }
    @Override
    protected boolean isRouteDisplayed() {
        // TODO Auto-generated method stub
        return false;
    }
    ...
}

3. 最后，在AndroidManifest.xml文件中，在<application>中添加一条配置：

    <application ...>  
        <uses-library android:name="com.google.android.maps"/>  
        ...  
    </application>  

大功告成，试试你的Google Map吧。关于Google Map的更多操作将在下一篇文章中继续分解。