Google Map 官方指定文檔地址:
https://developers.google.cn/maps/documentation/android-api/config
概覽
向 Android 應(yīng)用添加地圖的完整過程如下:
安裝 Android SDK是趴。
安裝并配置 Google Play 服務(wù) SDK涛舍,其中包括 Google Maps Android API。 如果您使用 Google Maps Mobile SDK for Work唆途,則必須下載并配置 Google Maps Mobile SDK for Work 靜態(tài)內(nèi)容庫富雅。
獲取 API 密鑰。 為實現(xiàn)此目的肛搬,您需要在 Google Developers Console 中注冊一個項目没佑,找到您的應(yīng)用的簽名證書,然后創(chuàng)建一個 API 密鑰温赔。
向您的應(yīng)用的清單文件添加所需設(shè)置蛤奢。
以下是有關(guān)整個過程各步驟的更多詳情。
安裝 Android SDK
Android Studio 是使用 Google Maps Android API 開發(fā)應(yīng)用的推薦開發(fā)環(huán)境陶贼。 此外也提供了針對其他開發(fā)環(huán)境的指南啤贩。 選擇與您的開發(fā)環(huán)境對應(yīng)的選項卡。
ANDROID STUDIO
帶 ADT 的 ECLIPSE
其他
按照指南 download 并install Android Studio拜秧。 然后添加所需的 packages痹屹,包括 Google Play 服務(wù)以及其他推薦軟件包。
安裝并配置 Google Play 服務(wù) SDK
您需要為應(yīng)用創(chuàng)建一個 Android 項目腹纳,以便完成此部分的步驟痢掠。 如果您尚未創(chuàng)建 Android 應(yīng)用,可以按照指南創(chuàng)建一個“hello world”應(yīng)用嘲恍。 請參閱創(chuàng)建 Android 項目。
Google Maps Android API 作為 Google Play 服務(wù) SDK 的一部分進(jìn)行分發(fā)雄驹。 您可以通過 Android SDK 管理器下載 Google Play 服務(wù) SDK佃牛。
如需了解詳細(xì)說明,請參閱 Google Play 服務(wù) 文檔医舆。
獲取 Google Maps API 密鑰
如需使用 Google Maps Android API俘侠,您必須在 Google Developers Console 上注冊您的應(yīng)用項目,并獲取可添加到應(yīng)用中的 Google API 密鑰蔬将。
您需要的 API 密鑰類型是 Android 密鑰爷速。
如需了解詳情,請參閱注冊和 API 密鑰霞怀。
向您的應(yīng)用的清單文件添加所需設(shè)置
編輯您的應(yīng)用的 AndroidManifest.xml
文件并添加以下設(shè)置惫东。
指定 Google Play 服務(wù)版本號
在 AndroidManifest.xml
的 <application>
元素內(nèi)添加以下聲明。 其作用是嵌入編譯應(yīng)用時所用 Google Play 服務(wù)的版本。
<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
指定您的 API 密鑰
務(wù)必按注冊和 API 密鑰中所述在 AndroidManifest.xml
文件中加入您的 API 密鑰廉沮。
指定 Android 權(quán)限
通過在 AndroidManifest.xml
中將 <uses-permission>
元素添加為 <manifest>
元素的子項颓遏,指定您的應(yīng)用需要的權(quán)限。
位置權(quán)限
如果您的應(yīng)用通過啟用 My Location 層訪問用戶的當(dāng)前位置滞时,您必須按位置數(shù)據(jù)指南中所述請求位置權(quán)限叁幢。
外部存儲權(quán)限
如果您以 Google Play 服務(wù) SDK 8.3 版或更高版本為目標(biāo),使用 Google Maps Android API 時不再需要 WRITE_EXTERNAL_STORAGE
權(quán)限坪稽。
如果您以 Google Play 服務(wù) SDK 的早期版本為目標(biāo)曼玩,則必須請求 android.permission.WRITE_EXTERNAL_STORAGE
權(quán)限。
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
注:如果您的應(yīng)用的目標(biāo)平臺是需要使用運行時權(quán)限的 API 級別 23 (Android 6.0)窒百,則應(yīng)以 Google Play 服務(wù) SDK 8.3 或更高版本為目標(biāo)黍判。
自動合并到清單文件中的權(quán)限
以下權(quán)限在 Google Play 服務(wù)清單文件中定義,它們會在編譯時自動合并到您的應(yīng)用的清單文件中贝咙。您不需要顯式地將它們添加到清單文件中:
android.permission.INTERNET
- 由 API 用于從 Google 地圖服務(wù)器下載地圖圖塊
android.permission.ACCESS_NETWORK_STATE
- 允許 API 檢查連接狀態(tài)样悟,以確定是否可以下載數(shù)據(jù)
指定對 OpenGL ES 第 2 版的要求
Google Maps Android API 使用 OpenGL ES 第 2 版來渲染地圖。 如果未安裝 OpenGL ES 第 2 版庭猩,您的地圖將不會出現(xiàn)窟她。 我們建議您在 AndroidManifest.xml
中添加以下 <uses-feature>
元素作為 <manifest>
元素的子元素:
<uses-feature android:glEsVersion="0x00020000" android:required="true"/>
其作用是將要求通知外部服務(wù)。 具體地講蔼水,其作用是防止 Google Play 商店在不支持 OpenGL ES 第 2 版的設(shè)備上顯示您的應(yīng)用腥例。