使用API 金鑰| Maps SDK for Android - Google Developers

API 金鑰是一組專屬ID，用於驗證與您專案有關的使用權限及帳單處理請求。

您的專案至少要有一個相關聯的API 金鑰。

建立API 金鑰的方法如下：. Google 地圖平台 總覽 產品 定價 說明文件 開始使用 開始使用Google地圖平台 API挑選器 計費和定價方式 報表與監控 地圖ID 常見問題 支援與資源 事件管理 地圖介面集 MapsJavaScriptAPI MapsSDKforAndroid MapsSDKforiOS MapsStaticAPI StreetViewStaticAPI MapsEmbedAPI 地圖網址 MapsElevationAPI 路徑介面集 DirectionsAPI DistanceMatrixAPI RoadsAPI 解決方案 產業解決方案 遊戲服務 運輸與物流 地點介面集 PlacesAPI PlacesSDKforAndroid PlacesSDKforiOS PlacesLibrary、MapsJavaScriptAPI GeocodingAPI GeolocationAPI TimeZoneAPI 其他資源 API安全性最佳做法 地圖涵蓋範圍詳細資料 最佳化指南 行動作業系統和軟體支援 推出階段 淘汰項目 資產追蹤方案 網址編碼 WordPress使用者 網誌 社群 StackOverflow GitHub YouTube Discord Twitter IssueTracker English BahasaIndonesia Deutsch Español Español–AméricaLatina Français Italiano Polski Português–Brasil TiếngViệt Türkçe Русский עברית العربيّة فارسی বাংলা ภาษาไทย 中文–简体 中文–繁體 日本語 한국어 登入 Android MapsSDKforAndroid 開始使用 聯絡銷售人員 指南 參考資料 範例 支援 Google 地圖平台 總覽 產品 定價 說明文件 更多 指南 參考資料 範例 支援 網誌 社群 更多 MapsSDKforAndroid 總覽 快速入門導覽課程 設定 設定GoogleCloud專案 使用API金鑰 設定AndroidStudio專案 版本 Beta版 MapsSDKforAndroid3.1.0Beta版 使用MapsSDK3.1.0Beta版Beta版 教學課程 含有標記的地圖 代表路徑和區域的折線和多邊形 選取目前位置 作業與概念 建立和設定地圖 新增地圖設定地圖地圖與圖塊座標新版地圖轉譯器(選用)街景服務全景商家和其他搜尋點精簡模式 與地圖互動 相機和檢視畫面控制項和手勢事件位置資料啟動Google地圖 在地圖上繪圖 標記資訊視窗形狀區域疊加層圖塊疊加層 管理標記和標籤衝突 使用雲端式地圖樣式設定進行自訂 總覽地圖樣式編輯器逐步操作說明管理地圖樣式使用縮放等級自訂搜尋點行為自訂建築物樣式樣式範例設計檢查清單 使用JSON樣式進行自訂 新增樣式化地圖使用樣式隱藏地圖項目樣式參考資料 強化無障礙功能 在WearOS上使用MapsAPI 開放原始碼程式庫 公用程式庫 總覽設定和示範GeoJSONKML熱視圖標記叢集多圖層 KTXKotlin擴充功能 MapsCompose程式庫 MapsRx程式庫 SecretsGradle外掛程式 政策與條款 用量與計費 回報與監控 服務條款 為GooglePlay的資料揭露規定做好準備 開始使用 開始使用Google地圖平台 API挑選器 計費和定價方式 報表與監控 地圖ID 常見問題 支援與資源 事件管理 地圖介面集 MapsJavaScriptAPI MapsSDKforAndroid MapsSDKforiOS MapsStaticAPI StreetViewStaticAPI MapsEmbedAPI 地圖網址 MapsElevationAPI 路徑介面集 DirectionsAPI DistanceMatrixAPI RoadsAPI 解決方案 產業解決方案 遊戲服務 運輸與物流 地點介面集 PlacesAPI PlacesSDKforAndroid PlacesSDKforiOS PlacesLibrary、MapsJavaScriptAPI GeocodingAPI GeolocationAPI TimeZoneAPI 其他資源 API安全性最佳做法 地圖涵蓋範圍詳細資料 最佳化指南 行動作業系統和軟體支援 推出階段 淘汰項目 資產追蹤方案 網址編碼 WordPress使用者 StackOverflow GitHub YouTube Discord Twitter IssueTracker 首頁 產品 Google地圖平台 說明文件 Android MapsSDKforAndroid 指南 提供意見 使用API金鑰 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

選取平台： Android iOS JavaScript 本主題將說明如何為MapsSDKforAndroid建立API金鑰、怎麼將金鑰加進應用程式，以及限制金鑰來保護應用程式安全的做法。

您必須在採用該SDK的所有應用程式中加進API金鑰。

事前準備 您的專案必須連結帳單帳戶並啟用MapsSDKforAndroid，才能開始使用MapsSDKforAndroid。

請參閱這篇文章，進一步瞭解如何在Cloud控制台中進行設定。

建立API金鑰 API金鑰是一組專屬ID，用於驗證與您專案有關的使用權限及帳單處理請求。

您的專案至少要有一個相關聯的API金鑰。

建立API金鑰的方法如下： 控制台 前往「Google地圖平台」>「憑證」頁面。

前往「憑證」頁面 在「憑證」頁面上，依序點選「建立憑證」>「API金鑰」。

「建立的API金鑰」對話方塊會顯示您新建立的API金鑰。

按一下「關閉」。

新建立的API金鑰會出現在「憑證」頁面的「API金鑰」下方。

(別忘了先為API金鑰設定限制，然後才在實際工作環境中使用。

) CloudSDK gcloudalphaservicesapi-keyscreate\ --project"PROJECT"\ --display-name"DISPLAY_NAME" 進一步瞭解GoogleCloudSDK、CloudSDK安裝和下列指令： gcloudalphaservicesapi-keyscreate 注意：您可以讓MapsSDKforAndroid和PlacesSDKforAndroid應用程式使用同一組API金鑰。

限制API金鑰 Google強烈建議您設定限制，只允許將API金鑰用於應用程式需要的API。

限制API金鑰可避免不必要的請求使用API金鑰，有助提升應用程式的安全性。

詳情請參閱「API安全性最佳做法」。

如果在Cloud控制台中限制API金鑰，應用程式限制將覆寫API限制涵蓋的所有API。

請遵循最佳做法，為每個應用程式及每個適用平台建立專屬API金鑰。

當您限制API金鑰時，必須提供用於簽署應用程式的簽署金鑰SHA-1憑證指紋。

憑證類型分為兩種： 偵錯憑證：請僅將這種憑證類型用於您要測試的應用程式和其他不在實際生產環境使用的程式碼。

請勿嘗試發布以偵錯憑證簽署的應用程式。

執行偵錯版本時，AndroidSDK工具會自動產生這個憑證。

發布憑證：準備將應用程式發布到應用程式商店時，請使用這個憑證。

執行發布子版本時，AndroidSDK工具會產生這個憑證。

如要進一步瞭解數位憑證，請參閱「簽署應用程式」指南。

如要瞭解如何取得憑證指紋，請參閱「驗證用戶端」一文。

如果您改為使用Play應用程式簽署功能，則必須前往Play管理中心的應用程式簽署頁面取得憑證指紋。

限制API金鑰的方法如下： 控制台 前往「Google地圖平台」>「憑證」頁面。

前往「憑證」頁面 選取要設定限制的API金鑰，畫面隨即顯示API金鑰屬性頁面。

在「金鑰限制」下方，設定下列限制： 應用程式限制： 選取「Android應用程式」。

按一下「+新增套件名稱和指紋」。

輸入您的套件名稱和SHA-1憑證指紋，例如： com.example.android.mapexample BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75 API限制： 按一下「限制金鑰」。

從「選取API」下拉式選單中點選「MapsSDKforAndroid」。

如果畫面上未列出MapsSDKforAndroid，表示您需要啟用該SDK。

如要完成變更，請按一下「儲存」。

CloudSDK 列出現有金鑰。

gcloudservicesapi-keyslist--project="PROJECT" 清除現有金鑰的目前限制。

gcloudalphaservicesapi-keysupdate"projects/PROJECT/keys/KEY_ID"\ --clear-restrictions 為現有金鑰設定新限制。

gcloudalphaservicesapi-keysupdate"projects/PROJECT/keys/KEY_ID"\ --api_target="maps-android-backend.googleapis.com" --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME" 進一步瞭解GoogleCloudSDK、CloudSDK安裝和下列指令： gcloudalphaservicesapi-keysupdate gcloudalphaservicesapi-keyslookup gcloudservicesapi-keyslist 後續步驟 取得API金鑰後，接下來請按照「設定AndroidStudio專案」一文中的說明來建立及設定專案。

提供意見 Exceptasotherwisenoted,thecontentofthispageislicensedundertheCreativeCommonsAttribution4.0License,andcodesamplesarelicensedundertheApache2.0License.Fordetails,seetheGoogleDevelopersSitePolicies.JavaisaregisteredtrademarkofOracleand/oritsaffiliates. Lastupdated2022-08-31UTC. [{ "type":"thumb-down", "id":"missingTheInformationINeed", "label":"缺少我需要的資訊" },{ "type":"thumb-down", "id":"tooComplicatedTooManySteps", "label":"過於複雜/步驟過多" },{ "type":"thumb-down", "id":"outOfDate", "label":"過時" },{ "type":"thumb-down", "id":"translationIssue", "label":"翻譯問題" },{ "type":"thumb-down", "id":"samplesCodeIssue", "label":"示例/程式碼問題" },{ "type":"thumb-down", "id":"otherDown", "label":"其他" }] [{ "type":"thumb-up", "id":"easyToUnderstand", "label":"容易理解" },{ "type":"thumb-up", "id":"solvedMyProblem", "label":"確實解決了我的問題" },{ "type":"thumb-up", "id":"otherUp", "label":"其他" }] 想進一步說明嗎？ StackOverflow 使用google-maps標記提出問題。

GitHub 運用現有樣本進行設計。

Discord 與其他開發人員交流，瞭解Google地圖平台。

IssueTracker 如果發生錯誤，請傳送錯誤報告給我們！ 瞭解詳情 常見問題 API挑選器 PlacesSDKforAndroid 平台 Android iOS 網路 網路服務 產品資訊 計費方式與方案簡介 與銷售人員聯絡 支援 服務條款 Android Chrome Firebase GoogleCloudPlatform 所有產品 條款 隱私權 訂閱GoogleDevelopers電子報 訂閱 English BahasaIndonesia Deutsch Español Español–AméricaLatina Français Italiano Polski Português–Brasil TiếngViệt Türkçe Русский עברית العربيّة فارسی বাংলা ภาษาไทย 中文–简体 中文–繁體 日本語 한국어