要想编写Google Map的应用首先需要 Google APIs 。需要在项目中导入Google map api。默认情况是android某个版本比如android 2.1，现在需要改为对应版本的Google apis，版本要和android版本一致。在默认的情况下Google API是没有的。这个google apis是同版本的android超集，包含了google的私有应用api。
### Android Google Map 入门详解
#### 一、准备工作
要想成功地开发一款基于Google Maps的应用程序，首先需要确保你的开发环境已经准备妥当。这包括申请必要的API密钥、设置正确的开发环境以及确保所有所需的组件都已经正确安装。
##### 1.1 申请Android Map API Key
Google Maps API 的使用需要一个特定的密钥，即API Key，以验证应用程序的身份。为了获取此密钥，你需要完成以下步骤：
1. **找到 debug.keystore 文件**：如果你使用Eclipse作为开发工具，可以通过“Windows”->“Preferences”找到 debug.keystore 文件的位置。
- **路径**：`C:\Documents and Settings\kangjinw\.android\debug.keystore`
2. **获取 debug.keystore 的 MD5 值**：在命令行窗口中运行以下命令来获取 debug.keystore 的 MD5 值。确保将路径替换为实际的 keystore 文件路径。
```
keytool -list -alias androiddebugkey -keystore "C:\Documents and Settings\kangjinw\.android\debug.keystore" -storepass android -keypass android
```
如果系统提示找不到 `keytool`，请确保已将 JDK 的 bin 目录添加到系统的 PATH 环境变量中。
3. **申请 Android Map API Key**：登录至 Google Maps API 注册页面（http://code.google.com/intl/zh-CN/android/maps-api-signup.html），按照指引输入你的 MD5 指纹信息并完成注册流程。
##### 1.2 创建基于 Google APIs AVD
在 Android 开发过程中，创建一个基于 Google APIs 的模拟器（AVD）非常重要，因为这能确保你的应用能够在包含 Google 服务的环境中运行。
1. **打开 AVD Manager**：在 Android Studio 中，通过“Tools”->“AVD Manager”打开 AVD Manager 界面。
2. **创建 AVD**：在 AVD Manager 中选择“Create Virtual Device”，然后选择一个设备配置文件，接着在系统镜像选项中选择带有 Google APIs 的 Android 版本。
##### 1.3 创建基于 Google APIs 工程
创建一个支持 Google Maps 的 Android 工程需要确保你的工程使用了正确的 Android SDK 和 Google APIs 版本。
1. **创建新项目**：在 Android Studio 中创建一个新的 Android 项目。
2. **配置项目**：在项目设置中，选择带有 Google APIs 的 Android 版本作为目标平台。
3. **导入 Google Maps API**：在项目的 build.gradle 文件中添加 Google Play 服务库的依赖项。
##### 1.4 连接手机及驱动的安装
为了确保应用程序可以在真实设备上运行和调试，你需要正确连接设备并安装相应的 USB 驱动。
1. **连接设备**：使用 USB 数据线将手机连接到计算机。
2. **安装驱动**：大多数情况下，Android Studio 会自动安装所需的 USB 驱动。如果没有自动安装，可以从 Android SDK 的 extras 目录下的 usb_driver 文件夹中找到驱动并手动安装。
#### 二、Google Map API 的使用
在熟悉了基本的准备工作之后，接下来可以开始学习如何使用 Google Maps API 来构建地图功能。
##### 2.1 编写最简单的 Android 谷歌地图应用
创建一个简单的 Android 谷歌地图应用涉及到几个关键步骤：
1. **添加权限**：确保在 AndroidManifest.xml 文件中添加了访问网络和显示地图所需的权限。
2. **配置地图视图**：在布局文件中添加 `<com.google.android.gms.maps.MapView>` 组件。
3. **初始化地图**：在 Activity 或 Fragment 中初始化地图对象，并处理地图加载完成后的事件。
##### 2.2 在 Android Map Overlay 中使用图片
要在 Android 地图上使用自定义图标或标记，你可以使用 Marker 或 Overlay 功能。这允许你在地图上放置自定义图像或图标。
1. **创建图标资源**：准备好要使用的图标资源，并将其添加到项目的 drawable 目录下。
2. **添加标记**：使用 `MarkerOptions` 对象来指定标记的位置、图标等属性，并调用 `map.addMarker()` 方法将标记添加到地图上。
#### 三、定位功能
除了展示地图外，许多地图应用还需要提供定位功能，以帮助用户了解当前位置或跟踪移动轨迹。
##### 3.1 定位 API 中主要的类
Google Maps API 提供了几个重要的类来实现定位功能：
- **LocationManager**：提供访问定位服务的功能，用于获取最佳定位提供者。
- **LocationProvider**：定位提供者的抽象类，用于周期性报告设备的地理位置。
- **LocationListener**：监听位置信息变化的接口，需要在 LocationManager 中注册。
##### 3.2 如何进行定位
1. **获取 LocationManager**：通过 getSystemService() 方法获取 LocationManager 实例。
2. **注册 LocationListener**：创建一个 LocationListener 实现类，并通过 LocationManager 的 requestLocationUpdates() 方法注册监听器。
3. **获取当前位置**：使用 getLastKnownLocation() 方法获取设备的最后已知位置。
##### 3.3 添加权限
为了让应用能够访问设备的定位服务，需要在 AndroidManifest.xml 文件中添加以下权限：
```xml
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
```
#### 四、搜索的使用
除了基本的地图展示和定位功能外，搜索也是地图应用中不可或缺的部分。Google Maps API 提供了一系列搜索相关的功能和服务。
1. **使用 Google Places API**：Google Places API 可以用来搜索地点、获取地点详情等。
2. **添加搜索框**：在应用界面中添加搜索框组件，并使用 Google Places API 进行地点搜索。
通过以上步骤，你可以创建一个具备基本功能的 Android Google Maps 应用。随着对 API 的深入了解和实践，你可以进一步扩展应用的功能，例如添加路线规划、兴趣点搜索等更高级的功能。
