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。