简介： 随着移动互联网应用的迅速发展，利用智能手机提供的实时地理位置信息服务功能扩展出众多 LBS(Location Based Service) 应用，将实时地理位置信息与手机的便捷、移动特性结合，为人们提供多种多样的应用场景，比如实时定位、导航、搜索周围好友、基于地理位置的信息推荐等。本文通过实例介绍如何开发基于 Google Map 的 Android 应用。
本文以实例介绍如何开发基于 Google Map 的 Android 应用，共分为五部分：1. 开发 Android 应用的准备以及 Google Map API 密钥的获取；2. 将 google 地图控件放入 Android 工程中；3. 添加地图缩放组件，以及地图模式，缩放比例的调整；4. 使用 Android 系统提供的地理位置信息的服务获取当前地理位置信息；5. 将当前地理位置信息以图标的方式显示在地图上。
本文将主要介绍如何在 Android 系统上开发基于 Google 地图的应用。在开始阅读这篇文章之前，需要具备基本的 Android 开发的相关知识。读者需要了解如何在 eclipse 开发简单的 android 应用程序，例如 Eclipse IDE 的配置和 Android SDK 的安装。
● Eclipse IDE(http://www.eclipse.org/downloads/)
● AndroidSDK(http://developer.android.com/sdk/index.html)
为了开发基于 Google map 的 Android 应用，同时还需要安装 Google APIs Add-on，以及创建包含有 Google API 的 Android 模拟器。
● Google APIs Add-on(http://code.google.com/android/add-ons/google-apis/installing.html)
● AndroidVirtual device Targeting Google APIs(http://developer.android.com/guide/developing/devices/index.html)
获取 Google 地图 API key，以及生成 keyStore 文件
使用 google map 第一步是要获得 google map API 密钥，一个密钥只对一个”目录”或者”域”有效，对于 Google 来说，获取密钥的过程其实也是认证的过程，在你获取密钥时，需要同意 Google 所列出的一些法律条款，所以在你使用获取密钥后，Google 默认你已经同意了其地图使用的条款。
获取密钥的过程可以简单分为两个阶段：
通过 JDK( 本文中所指的 JDK 均为 Oracle JDK) 中自带的 Keytool.exe 工具来生成证书，Keytool.exe 可以在 %JAVA_HOME%\jdk1.6.0_21\bin 里找到，
为了开发和调试基于 Google Map 的 Android 应用，我们可以使用在 Android 应用调试模式下的证书 debug.keystore，该文件一般存放在 : %userprofile%/.android/
在笔者的 Windows XP 系统中，该文件的存放路径为
C:\Documents and Settings\Administrator\.android\
将 debug.keystore 文件复制到 Keytool 工具的目录下，然后通过下面的命令来获取证书的 MD5 值 : keytool.exe -list -alias androiddebugkey -keystore debug.keystore -storepass android -keypass android
图 2. 获取证书的 MD5 值
登陆 http://code.google.com/android/maps-api-signup.html，通过使用之前获得的 MD5 值，来完成 Google Map API 密钥的申请。图 3 为申请成功的截图。
1.建立新的 Android 工程，并命名为 GoogleMapExample，开发基于 Google Map 的应用需要指定该工程的 build target 为 Google APIs。
图 4. 创建 Android 工程界
2.开发 Android 应用可以在手机或者模拟器上进行调试，如果使用模拟器进行开发，首先需要创建 Android 模拟器，并且指定该模拟器的 target 为 Google APIs。
图 5. 创建 Android 模拟器界面
3.设置示例工程的运行环境，确保示例工程运行在包含有 Google API 的目标模拟器上。
图 6. 设置示例工程运行环境界面
4.在模拟器上运行 GoogleMapExample 示例工程，模拟器应该有如图 7 的输出。自此，开发基于 Google Map 应用的工程就初步搭建起来了，接下来我们一步一步来将地图控件添加进 GoogleMapExample 应用中
图 7. 运行结果界面
将 Google Map 控件添加到 GoogleMapExample 工程中
首先，在 AndroidManifest.xml 文件中添加对于 Google Map 库的引用。通过使用 uses-library 标签来添加 google map 库到当前应用中。
清单 1. 添加对于 Google Map 库的引用
|
1 |
<uses-library android:name="com.google.android.maps" /> |
添加的相应的访问权限：
● android.permission.ACCESS_COARSE_LOCATION: 允许应用通过网络信息获取当前地理位置信息的权限。
● android.permission.ACCESS_FINE_LOCATION: 允许应用通过 GPS 获取当前地理位置信息的权限，较网络获得的地理位置信息更为精确。
● android.permission.INTERNET: 允许应用访问网络的权限。
最终的 AndroidManifest.xml 文件示例如下：
清单 2. AndroidManifest.xml 文件
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.android.mapExample" android:versionCode="1" android:versionName="1.0"> <uses-sdk android:minSdkVersion="3" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> <uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <application android:icon="@drawable/icon" android:label="@string/app_name"> <uses-library android:name="com.google.android.maps" /> <activity android:name=".GoogleMapExampleActivity" 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> |
其次，将 MapView 控件添加进布局文件 main.xml 中，并将 1.3 中获得的 API 填入 MapView 控件的声明中。
清单 3. main.xml 文件、
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
<?xml version="1.0" encoding="utf-8"?> <LinearLayout 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 android:id="@+id/mapView" android:layout_width="fill_parent" android:layout_height="fill_parent" android:clickable="true" android:apiKey="0gtIEXVeu0g96nXpxjvByVW9hs7V0mDiuNHRwRw" /> </LinearLayout> |
第三，将 GoogleMapExampleActivity 的继承类修改为 MapActivity，并添加 com.google.android.maps.MapActivity包，重写 isRouteDisplayed 方法，由于示例中没有正在显示的路线信息，这里我们返回 false 即可。
清单 4. GoogleMapExampleActivity 类
|
1 2 3 4 5 6 7 8 9 10 11 |
public class GoogleMapExampleActivity extends MapActivity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); } @Override protected boolean isRouteDisplayed() { return false; } } |
编译并且运行，将会得到如图 8 所示的地图，这时地图控件已经被我们成功的添加进示例工程中了。
添加缩放控件并控制缩放比例，切换地图显示类型（卫星，地图，街道）
Google 地图 MapView 对象自带有控制缩放比例的组件，我们可以通过调用 MapView 对象的 setBuiltInZoomControls方法来完成添加或者移除缩放控件。
1.通过在 layout 文件 main.xml 中的 id 获取找到 MapView 对象
|
1 |
mapView = (MapView) findViewById(R.id.mapView); |
2.在 mapView 对象上调用 setBuiltInZoomControls 方法，这里传入 boolean 类型的参数，true 和 false 分别表示添加或者移除缩放组件
清单 6. 调用 setBuiltInZoomControls 方法
|
1 |
mapView.setBuiltInZoomControls(true); |
需要提到的是，如果添加了缩放控件，它会在第一次触击地图的时候生效，如图 9 所示。
通过 MapControl 来控制缩放比例，通过获取 MapView 的 MapControl 对象，控制缩放比例。这里我们设置 16 档为当前缩放大小。
|
1 2 |
mapController = mapView.getController(); mapController.setZoom(16); |
Google 地图缩放比例共分为 21 档，具体的缩放划分可以参考 google 文档，以及链接 http://greg-koppel.site88.net/maps/InfoDisplay.html
切换地图的显示类型，Google 地图提供了三种地图的显示方式，分别为卫星，地图，街道，默认设置为街道模式，这些模式的切换可以通过调用 MapView 对象提供的相应方法来完成切换。
最终的代码示例：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
@Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); mapView = (MapView) findViewById(R.id.mapView); // 街道模式（默认设置） mapView.setStreetView(true); // 卫星模式 //mapView.setSatellite(true); // 是否显示交通信息 // mapView.setTraffic(true); mapView.setBuiltInZoomControls(true); mapController = mapView.getController(); mapController.setZoom(16); } |
Android 系统提供的获取地理位置信息的服务，通过该服务开发者不仅可以方便的获取当前 Android 设备的地理位置信息，并且还提供定制地理位置信息获取的方式，位置变化追踪等。
LocationManager，LocationProviders 这两个类在 Android 系统中，提供获取当前地理位置信息的功能。
● LocationManager: 提供访问 Android 地理信息服务的接口。
● LocationProvider: 提供多种定位方式供开发者选择（GPS, NETWORK 定位等）。
● Critieria：设置一系列的查询条件，来获取相应的 Location Provider。
下面通过一个具体的示例来说明，如何获取 Android 系统中最后一次更新的地理位置信息。
1.根据应用需求创建 Criteria 对象，设定获取地理位置信息的精度，方向信息等。
2.获取当前符合步骤 1 定义的规则最优的 LocationProvider。
3.获取 LocationManager 对象来访问 android 系统地理位置信息服务。
4.通过 LocationManager 对象提供的方法获取系统最后一次更新的地理位置信息。
示例代码如下：
清单 9. 获取 Android 系统中最后一次更新的地理位置信息
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
mapView = (MapView) findViewById(R.id.mapView) |
