原帖地址： http://www.verydemo.com/demo_c137_i2461.html
Google Maps Android API V2配置详解
首先自我介绍下，本人在一所高职学院教软件设计，教学同时也参与了不少.NET平台项目，但却很少触及与JAVA相关的技术，集成性差、配置麻烦的JAVA开发环境总让我避而远之。然而，时过境迁，Android强大的影响力已非微软所能及，它被广泛的应用于智能终端、平板电视和各种嵌入式设备上，因此系里决定在明年开设Android开发课程。为了扩充自己的知识储备，为今后的项目开发奠定基础，我毅然决然的承担了来年的教学任务。初涉Android，凭借自己扎实的面向对象理论基础，并未在语法上遇到什么困难，设计与代码分离、资源引用机制、事件机制（侦听器）、意图、服务等知识的学习都驾轻就熟，唯一让我头疼的还是对Eclipse调试环境的陌生，特别在LogCat中寻找异常消息如大海捞针。不过这都不算问题，当学习到Google地图时，我才发现之前遇到的困难都是浮云，光开发前配置花掉了我一整天时间。原因在于Google
Maps 已从V1版本升级到V2版本，Google不再为开发者提供V1版本API Key的申请，网上一抓大把的学习资料全是V1版本的，讲得倒是全面透彻，可V2版本配置方式与V1版本大相径庭，相较更为麻烦，而且由于其刚出现不久，很难在互联网搜索到一篇有用的资料。幸好，有以下两篇文档，对我完成配置给予了极大的帮助。
google提供的官方文档：https://developers.google.com/maps/documentation/android/start?hl=zh-CN，包含了所有的基本配置步骤，当然，试验证明，操作过程中出现的各种问题才让人头疼。
特别感谢“圣骑士Wind的博客”中一篇博文：Google Maps Android API V2 使用及问题解决，见 http://www.cnblogs.com/mengdd/archive/2013/01/01/2841390.html，囊括了所有的操作步骤以及配置中问题的解决方案，但针对不同版本Android SDK配置方式的叙述还不够详尽。
接下来，我将在以上文档的基础上，以Android SDK2.3.3和Android SDK4.2为例，对Google Maps Android API V2配置进行更为详细的说明。废话少说，直接进入正文。
1、安装Google Play Service SDK
在Eclipse工具栏上打开Android SDK Manager，下载并安装Extras下的Google Play Service：
2、获取API KEY：
（1）打开Google APIs Console：https://code.google.com/apis/console/，登陆gmail账号，若尚未申请，请注册。
登陆并打开左上角下拉菜单，点击Create...，创建项目（名称任意，默认API Project）后，显示如下界面：
、、、
（2）选择左边菜单中的Services，在出现的All Services列表中将Google Map Android API v2的开关置为ON：
（3）单击左边菜单中的API Access，在出现的API Access界面中单击Create new Android key...按钮，弹出Config Android Key 对话框：
（4）仔细阅读操作提示，意思大致是google将根据你客户端设备的SHA1指纹和项目包名生成地图API调用密钥，因此要求你首先用"keytool -list -v -keystore mystore.keystore"命令获取客户端设备的SHA1指纹，命令中的mystore.keystore指一个扩展名为keystore的数字证书库文件路径，该文件保存了开发者的数字证书以及认证的公钥。文件存储于虚拟机所在目录，即.android目录，路径可通过Eclipse中的window-preference-Android-Build查看，见下图：
以我的.keystore文件路径为例，在dos输入提取数字证书SHA1指纹的命令：keytool -list -v -keystore "D:\Program Files\android-sdk_r20-windows\android-sdk-windows\.android\debug.keystore"，控制台提示输入密码，输入默认密码android后回车，控制台显示证书信息如下图：
注意：VI版的Google API在获取API KEY时使用的是MD5指纹，而V2版使用SHA1指纹。复制SHA1指纹粘贴到Config Android Key 对话框，并在其后加上调试应用程序的包名，以分号隔开，如下图：
最后，单击Create按钮，网页回到overview视图，可在右侧看到密钥信息：
至此，获取API Key成功。需要说明的是，如果在.android文件夹下找不到debug.keystore数字证书文件，可用以下命令生成：
keytool -genkey -v -keystore debug.keystore -alias androiddebugkey -keyalg RSA -validity 1000 输入密码，确认密码后，不用管证书发行人信息，一系列回车即可完成操作。
3、把API Key加入应用程序
新建Android应用程序，注意Package Name需与申请API Key所使用的包名一致，并选择带Google地图的SDK版本。
为使项目顺利加载Google地图，需对以下文件进行简单的配置：
（1）AndroidManifest.xml：
在文件中加入以下描红节点，并根据后续提示进行修改。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="xxx.xxx.mylbs"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="17" />
<permission
android:name="cn.edu.myvtc.lbs.permission.MAPS_RECEIVE"
android:protectionLevel="signature"/>
<uses-permission android:name="cn.edu.myvtc.lbs.permission.MAPS_RECEIVE"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-feature android:glEsVersion="0x00020000" android:required="true"/>
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<meta-data
android:name="com.google.android.maps.v2.API_KEY"
android:value="AIzaSyCovXw_..........GfBsmP57vmQuun8"/>
<activity
android:name="cn.edu.myvtc.lbs.MainActivity"
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>
</manifest>
说明：
①<uses-permission android:name="android.permission.INTERNET"/>必不可少，否则应用无法访问互联网，AVD会出现白地图。
②<uses-permission android:name="xxx.xxx.mylbs.permission.MAPS_RECEIVE"/>节点中的 xxx.xxx.mylbs请替换为你的项目包名。
③<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="AIzaSyCovXw_..................fBsmP57vmQuun8"/>节点应加入到<Application>节点下，并将value值替换为第2步申请到的API Key。
（2）布局文件activity_main.xml：
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity" >
<fragment xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/map" android:layout_width="match_parent" android:layout_height="match_parent" class="com.google.android.gms.maps.MapFragment"/>
</RelativeLayout>
注意：如果你的Android SDK为3.1（API 12）之前版本，如Android 2.3.3，则需要将描红节点中的MapFragment修改为SupportMapFragment，因为MapFragment只在API 12及之后的版本才有，所以对于之前的版本需要使用Support Library来进行辅助。
（3）MainActivity.java
如果你的Android SDK为3.1（API 12）之前版本，如Android 2.3.3，则需要进行以下编码，否则请跳过该步骤。
package xxx.xxx.mylbs;
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
public class MainActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}
由于API 12之前的SDK必须借助FragmentActivity对Fragment进行管理，因此，使用了Fragment标签的活动须继承自FragmentActivity，该Activity由android.support.v4.app包定义。
4、新建虚拟机并运行程序
单击Eclipse工具栏上的AVD Manager新建一个虚拟机，需要强调的是虚拟机的SDK Target请选择不带Google地图的API版本，切记！！！否则后续步骤中在虚拟机安装vending.apk和gms.apk无法成功。
然后运行程序，Eclipse会提示找不到适合的虚拟机，是否加入新的虚拟机，单击No，在Android Device Chooser中选择"launch a new Android Virtual Device"，选择列表中之前新建的虚拟机后单击OK。程序运行起来后出现异常，查看LogCat有以下提示：
明显，该异常是由于找不到SupportMapFragment类的定义导致无法实例化，该类由com.google.android.gms.maps包定义。要引入这个包，需加载Google Play Services。Google Play Services是Google推出的新的平台，帮助开发者在应用中更好地集成Google的产品。Google Play services v2.0包含了两个新的API：
Google Maps Android API：允许开发者在Android应用中集成Android版Google地图的最新特性。 支持Froyo（Android 2.2）之后的版本（API level 8+）。 新的API使用基于矢量的地图，支持2D和3D视图，允许用户通过简单的手势来倾斜和旋转地图，并可以查看卫星、混合、地形和交通等视图，甚至可以查看许多主要机场和商场的室内地图（美国可用）。
Photo Sphere API（360度全景拍照）：在Google Play services v2.0中，包含了一个新的Photo Sphere API和文档，使得开发者、企业或摄影师可以探索新的拍照体验。
5、引用Google Play Services
（1）Google Play Services导入工作空间。File-Import，选中Android节点下的Existing Android Code Into Workspace，单击Next，之后Browse...，找到路径下的<android-sdk-folder>/extras/google/google_play_services/libproject/google-play-services_lib并确定，勾选Copy projects
into workspace，然后选择Finish。
（2）添加引用。选中Package Explorer中的项目，单击Project-Properties-Android，在对话框的Library区域中单击Add按钮，选中google-play-services_lib后单击OK，LIbrary列表中出现正确的引用项，之后单击OK关闭对话框。
之后再次运行程序，在AVD中可能会出现以下两种提示：
This app won't run without Google Play services,which are missing from your phone或This app won't run unless you update Google Play services.
这是因为AVD不包含Google Play Services，解决的方法就是在AVD上安装两个包（Google Play Store和Google Play services）：vending.apk和gms.apk，（给一个网盘链接：http://pan.baidu.com/share/link?shareid=190602&uk=2701745266）
6、安装vending.apk和gms.apk
（1）下载vending.apk和gms.apk到任意文件夹
（2）启动AVD
（3）进入cmd，当前目录指向两个apk所在的目录，分别输入命令：
adb install com.anroid.vending.apk 回车执行
adb install com.google.android.gms.apk 回车执行
控制台输出success时，安装成功。
7、大功告成！
再次启动程序，地图出现！
结语：
本该更早的记录工作和学习中的所学所得，但平时事务实在繁忙，难以抽出时间写这么大段的文字。最近，重拾书本开始学习Android，记录学习点滴，改变学习习惯也成为我第一篇博文的契机。同时，希望这篇博文能帮助更多如我一样的Android初学者，也拜谢各位牛人不吝拍砖 ^_^
首先自我介绍下，本人在一所高职学院教软件设计，教学同时也参与了不少.NET平台项目，但却很少触及与JAVA相关的技术，集成性差、配置麻烦的JAVA开发环境总让我避而远之。然而，时过境迁，Android强大的影响力已非微软所能及，它被广泛的应用于智能终端、平板电视和各种嵌入式设备上，因此系里决定在明年开设Android开发课程。为了扩充自己的知识储备，为今后的项目开发奠定基础，我毅然决然的承担了来年的教学任务。初涉Android，凭借自己扎实的面向对象理论基础，并未在语法上遇到什么困难，设计与代码分离、资源引用机制、事件机制（侦听器）、意图、服务等知识的学习都驾轻就熟，唯一让我头疼的还是对Eclipse调试环境的陌生，特别在LogCat中寻找异常消息如大海捞针。不过这都不算问题，当学习到Google地图时，我才发现之前遇到的困难都是浮云，光开发前配置花掉了我一整天时间。原因在于Google
Maps 已从V1版本升级到V2版本，Google不再为开发者提供V1版本API Key的申请，网上一抓大把的学习资料全是V1版本的，讲得倒是全面透彻，可V2版本配置方式与V1版本大相径庭，相较更为麻烦，而且由于其刚出现不久，很难在互联网搜索到一篇有用的资料。幸好，有以下两篇文档，对我完成配置给予了极大的帮助。
google提供的官方文档：https://developers.google.com/maps/documentation/android/start?hl=zh-CN，包含了所有的基本配置步骤，当然，试验证明，操作过程中出现的各种问题才让人头疼。
特别感谢“圣骑士Wind的博客”中一篇博文：Google Maps Android API V2 使用及问题解决，见 http://www.cnblogs.com/mengdd/archive/2013/01/01/2841390.html，囊括了所有的操作步骤以及配置中问题的解决方案，但针对不同版本Android SDK配置方式的叙述还不够详尽。
接下来，我将在以上文档的基础上，以Android SDK2.3.3和Android SDK4.2为例，对Google Maps Android API V2配置进行更为详细的说明。废话少说，直接进入正文。
1、安装Google Play Service SDK
在Eclipse工具栏上打开Android SDK Manager，下载并安装Extras下的Google Play Service：
2、获取API KEY：
（1）打开Google APIs Console：https://code.google.com/apis/console/，登陆gmail账号，若尚未申请，请注册。
登陆并打开左上角下拉菜单，点击Create...，创建项目（名称任意，默认API Project）后，显示如下界面：
、、、
（2）选择左边菜单中的Services，在出现的All Services列表中将Google Map Android API v2的开关置为ON：
（3）单击左边菜单中的API Access，在出现的API Access界面中单击Create new Android key...按钮，弹出Config Android Key 对话框：
（4）仔细阅读操作提示，意思大致是google将根据你客户端设备的SHA1指纹和项目包名生成地图API调用密钥，因此要求你首先用"keytool -list -v -keystore mystore.keystore"命令获取客户端设备的SHA1指纹，命令中的mystore.keystore指一个扩展名为keystore的数字证书库文件路径，该文件保存了开发者的数字证书以及认证的公钥。文件存储于虚拟机所在目录，即.android目录，路径可通过Eclipse中的window-preference-Android-Build查看，见下图：
以我的.keystore文件路径为例，在dos输入提取数字证书SHA1指纹的命令：keytool -list -v -keystore "D:\Program Files\android-sdk_r20-windows\android-sdk-windows\.android\debug.keystore"，控制台提示输入密码，输入默认密码android后回车，控制台显示证书信息如下图：
注意：VI版的Google API在获取API KEY时使用的是MD5指纹，而V2版使用SHA1指纹。复制SHA1指纹粘贴到Config Android Key 对话框，并在其后加上调试应用程序的包名，以分号隔开，如下图：
最后，单击Create按钮，网页回到overview视图，可在右侧看到密钥信息：
至此，获取API Key成功。需要说明的是，如果在.android文件夹下找不到debug.keystore数字证书文件，可用以下命令生成：
keytool -genkey -v -keystore debug.keystore -alias androiddebugkey -keyalg RSA -validity 1000 输入密码，确认密码后，不用管证书发行人信息，一系列回车即可完成操作。
3、把API Key加入应用程序
新建Android应用程序，注意Package Name需与申请API Key所使用的包名一致，并选择带Google地图的SDK版本。
为使项目顺利加载Google地图，需对以下文件进行简单的配置：
（1）AndroidManifest.xml：
在文件中加入以下描红节点，并根据后续提示进行修改。
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="xxx.xxx.mylbs"
android:versionCode="1"
android:versionName="1.0" >
<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="17" />
<permission
android:name="cn.edu.myvtc.lbs.permission.MAPS_RECEIVE"
android:protectionLevel="signature"/>
<uses-permission android:name="cn.edu.myvtc.lbs.permission.MAPS_RECEIVE"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-feature android:glEsVersion="0x00020000" android:required="true"/>
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<meta-data
android:name="com.google.android.maps.v2.API_KEY"
android:value="AIzaSyCovXw_..........GfBsmP57vmQuun8"/>
<activity
android:name="cn.edu.myvtc.lbs.MainActivity"
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>
</manifest>
说明：
①<uses-permission android:name="android.permission.INTERNET"/>必不可少，否则应用无法访问互联网，AVD会出现白地图。
②<uses-permission android:name="xxx.xxx.mylbs.permission.MAPS_RECEIVE"/>节点中的 xxx.xxx.mylbs请替换为你的项目包名。
③<meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="AIzaSyCovXw_..................fBsmP57vmQuun8"/>节点应加入到<Application>节点下，并将value值替换为第2步申请到的API Key。
（2）布局文件activity_main.xml：
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity" >
<fragment xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/map" android:layout_width="match_parent" android:layout_height="match_parent" class="com.google.android.gms.maps.MapFragment"/>
</RelativeLayout>
注意：如果你的Android SDK为3.1（API 12）之前版本，如Android 2.3.3，则需要将描红节点中的MapFragment修改为SupportMapFragment，因为MapFragment只在API 12及之后的版本才有，所以对于之前的版本需要使用Support Library来进行辅助。
（3）MainActivity.java
如果你的Android SDK为3.1（API 12）之前版本，如Android 2.3.3，则需要进行以下编码，否则请跳过该步骤。
package xxx.xxx.mylbs;
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
public class MainActivity extends FragmentActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
}
由于API 12之前的SDK必须借助FragmentActivity对Fragment进行管理，因此，使用了Fragment标签的活动须继承自FragmentActivity，该Activity由android.support.v4.app包定义。
4、新建虚拟机并运行程序
单击Eclipse工具栏上的AVD Manager新建一个虚拟机，需要强调的是虚拟机的SDK Target请选择不带Google地图的API版本，切记！！！否则后续步骤中在虚拟机安装vending.apk和gms.apk无法成功。
然后运行程序，Eclipse会提示找不到适合的虚拟机，是否加入新的虚拟机，单击No，在Android Device Chooser中选择"launch a new Android Virtual Device"，选择列表中之前新建的虚拟机后单击OK。程序运行起来后出现异常，查看LogCat有以下提示：
明显，该异常是由于找不到SupportMapFragment类的定义导致无法实例化，该类由com.google.android.gms.maps包定义。要引入这个包，需加载Google Play Services。Google Play Services是Google推出的新的平台，帮助开发者在应用中更好地集成Google的产品。Google Play services v2.0包含了两个新的API：
Google Maps Android API：允许开发者在Android应用中集成Android版Google地图的最新特性。 支持Froyo（Android 2.2）之后的版本（API level 8+）。 新的API使用基于矢量的地图，支持2D和3D视图，允许用户通过简单的手势来倾斜和旋转地图，并可以查看卫星、混合、地形和交通等视图，甚至可以查看许多主要机场和商场的室内地图（美国可用）。
Photo Sphere API（360度全景拍照）：在Google Play services v2.0中，包含了一个新的Photo Sphere API和文档，使得开发者、企业或摄影师可以探索新的拍照体验。
5、引用Google Play Services
（1）Google Play Services导入工作空间。File-Import，选中Android节点下的Existing Android Code Into Workspace，单击Next，之后Browse...，找到路径下的<android-sdk-folder>/extras/google/google_play_services/libproject/google-play-services_lib并确定，勾选Copy projects
into workspace，然后选择Finish。
（2）添加引用。选中Package Explorer中的项目，单击Project-Properties-Android，在对话框的Library区域中单击Add按钮，选中google-play-services_lib后单击OK，LIbrary列表中出现正确的引用项，之后单击OK关闭对话框。
之后再次运行程序，在AVD中可能会出现以下两种提示：
This app won't run without Google Play services,which are missing from your phone或This app won't run unless you update Google Play services.
这是因为AVD不包含Google Play Services，解决的方法就是在AVD上安装两个包（Google Play Store和Google Play services）：vending.apk和gms.apk，（给一个网盘链接：http://pan.baidu.com/share/link?shareid=190602&uk=2701745266）
6、安装vending.apk和gms.apk
（1）下载vending.apk和gms.apk到任意文件夹
（2）启动AVD
（3）进入cmd，当前目录指向两个apk所在的目录，分别输入命令：
adb install com.anroid.vending.apk 回车执行
adb install com.google.android.gms.apk 回车执行
控制台输出success时，安装成功。
7、大功告成！
再次启动程序，地图出现！
结语：
本该更早的记录工作和学习中的所学所得，但平时事务实在繁忙，难以抽出时间写这么大段的文字。最近，重拾书本开始学习Android，记录学习点滴，改变学习习惯也成为我第一篇博文的契机。同时，希望这篇博文能帮助更多如我一样的Android初学者，也拜谢各位牛人不吝拍砖 ^_^