Google Maps Android API v2 简介

通过Google Maps Android API，你可以给你的应用程序添加基于Google Maps数据的地图。那些API自动处理对于Google Maps服务器的访问，数据下载，地图显示，及对地图手势的相应。你也可以使用API调用来给一个基本的地图添加markers，polygons，和overlays，及改变一个特定的地图区域的用户视图。这些对象为地图位置提供了额外的信息，并允许用户与地图进行交互。这些API使你可以给一幅地图添加这样的一些图形：

• 固定在地图上特定位置的图标(Markers)。
• 线段的集合(Polylines).
• 闭合的线段(Polygons)。
• 固定在地图上特定位置的Bitmap图形(Ground Overlays)。
• 显示在基本地图片上面的一系列图像(Tile Overlays)。

读者

这份文档适用于熟悉Android开发及面向对象编程概念的读者。你也应该熟悉用户眼中的Google Maps。

这份概念性的文档主要用于使你能够快速的开始浏览及使用Google Maps Android API开发应用程序。你也许也想要参考一些参考文档来了解类和方法特定的详细信息。

商用Google Maps Mobile SDK

商用 Google Maps Mobile SDK 许可，同时为iOS版 Google Maps SDK及Google Maps Android API提供了增强功能。如果你已经购买了一份Google Maps Mobile SDK的商业许可，请参考 商业Google Maps API文档，以获取额外的补充的信息。

归属要求

如果你在你的应用程序中使用了 Google Maps Android API，你必须在你的应用程序中包含Google Play Services归属文本以作为“法律声明”的一部分。建议包含法律声明作为一个独立的菜单项，或者作为一个“关于”菜单项的一部分。

通过调用GooglePlayServicesUtil.getOpenSourceSoftwareLicenseInfo可以获得归属文本。

示例代码

示例代码是与 Google Play services SDK 绑定的。首先，你必须通过如下方法添加Google Play服务作为一个Android library项目：

1. 选择File > Import > Android > Existing Android Code Into Workspace 并点击 Next。
2. 选择Browse...，进入<android-sdk-folder>/extras/google/google_play_services/libproject/google-play-services_lib，然后点击Finish。

一旦你已经安装了Google Play services，你可以查看示例代码，或在本地运行示例app。示例app是一个Eclipse工程，你可以用如下方法在你的设备上来运行它：

1. 选择File > Import > Android > Existing Android Code Into Workspace并点击Next。
2. 选择Browse...，进入<android-sdk-folder>/extras/google/google_play_services/samples/maps，并点击Finish。
3. 选择Project > Properties，选择Java Build Path，并导航到Libraries。
4. 选择Add External Jars，包含如下的jar文件，然后点击OK：<android-sdk-folder>/extras/android/support/v4/android-support-v4.jar。在Order and Export标签，确保这个jar是选中的。
5. 添加你自己的Google Maps Android API key。
6. 选择Run > Run来测试示例app。

译自https://developers.google.com/maps/documentation/android/intro。关于Google maps 示例app的运行方法还是蛮有用的，不用再对着eclipse中那一堆红色的x号迷茫了。

Done。