取得Google Maps API 金鑰- Xamarin - Microsoft Learn

如何取得Google 地圖API 金鑰，以將地圖功能新增至您的應用程式。

... keytool -list -v -keystore [STORE FILENAME] -alias [KEY NAME] -storepass ... 跳到主要內容 已不再支援此瀏覽器。

請升級至MicrosoftEdge，以利用最新功能、安全性更新和技術支援。

下載MicrosoftEdge InternetExplorer和MicrosoftEdge的詳細資訊 目錄 結束焦點模式 閱讀英文 儲存 目錄 閱讀英文 儲存 列印 Twitter LinkedIn Facebook 電子郵件 目錄 取得GoogleMapsAPI金鑰 發行項 09/21/2022 7位參與者 意見反應 本文內容 若要在Android中使用Google地圖功能，您必須向Google註冊地圖API金鑰。

在您這麼做之前，您只會在應用程式中看到空白方格，而不是地圖。

您必須取得Google地圖AndroidAPIv2金鑰-來自舊版Google地圖AndroidAPI金鑰v1的金鑰將無法運作。

取得地圖APIv2金鑰牽涉到下列步驟： 擷取用來簽署應用程式之金鑰存放區的SHA-1指紋。

在GoogleAPI主控台中建立專案。

取得API金鑰。

取得簽署金鑰指紋 若要向Google要求地圖API金鑰，您必須知道用來簽署應用程式的金鑰存放區的SHA-1指紋。

一般而言，這表示您必須判斷偵錯金鑰存放區的SHA-1指紋，然後判斷用來簽署應用程式的金鑰存放區的SHA-1指紋以供發行。

VisualStudio VisualStudioforMac 根據預設，您可以在下列位置找到用來簽署Xamarin.Android應用程式的偵錯版本的金鑰存放區： C：\Users\[USERNAME]\AppData\Local\Xamarin\MonoforAndroid\debug.keystore 您可以從JDK執行keytool命令來取得金鑰儲存區的相關資訊。

此工具通常位於JAVAbin目錄中： C：\ProgramFiles\Android\jdk\microsoft_dist_openjdk_[VERSION]\bin\keytool.exe 根據預設，您可以在下列位置找到用來簽署Xamarin.Android應用程式的偵錯版本的金鑰存放區： /Users/[USERNAME]/.local/share/Xamarin/MonoforAndroid/debug.keystore 您可以從JDK執行keytool命令來取得金鑰儲存區的相關資訊。

此工具通常位於JAVAbin目錄中： /System/Library/JAVA/JAVAVirtualMachines/[VERSION].jdk/Contents/Home/bin/keytool 使用下列命令執行keytool，(使用上述檔案路徑)： keytool-list-v-keystore[STOREFILENAME]-alias[KEYNAME]-storepass[STOREPASSWORD]-keypass[KEYPASSWORD] Debug.keystore範例 針對自動為您建立以進行偵錯)的預設偵錯金鑰(，請使用此命令： VisualStudio VisualStudioforMac keytool.exe-list-v-keystore"C:\Users\[USERNAME]\AppData\Local\Xamarin\MonoforAndroid\debug.keystore"-aliasandroiddebugkey-storepassandroid-keypassandroid keytool-list-v-keystore/Users/[USERNAME]/.local/share/Xamarin/Mono\for\Android/debug.keystore-aliasandroiddebugkey-storepassandroid-keypassandroid 生產金鑰 將應用程式部署至GooglePlay時，必須使用私密金鑰進行簽署。

keytool必須使用私密金鑰詳細資料來執行，以及用來建立生產Google地圖API金鑰所產生的SHA-1指紋。

在部署之前，請記得使用正確的Google地圖API金鑰更新AndroidManifest.xml檔案。

Keytool輸出 您應該會在主控台視窗中看到類似下列輸出的內容： Aliasname:androiddebugkey Creationdate:Jan01,2016 Entrytype:PrivateKeyEntry Certificatechainlength:1 Certificate[1]: Owner:CN=AndroidDebug,O=Android,C=US Issuer:CN=AndroidDebug,O=Android,C=US Serialnumber:4aa9b300 Validfrom:MonJan0108:04:04UTC2013until:MonJan0118:04:04PST2033 Certificatefingerprints: MD5:AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9 SHA1:BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75 Signaturealgorithmname:SHA1withRSA Version:3 您將在本指南稍後的SHA1)之後，使用SHA-1指紋(。

建立API專案 擷取簽署金鑰存放區的SHA-1指紋之後，您必須在GoogleAPI主控台中建立新專案，(或將Google地圖AndroidAPIv2服務新增至現有的專案)。

在瀏覽器中，流覽至Google開發人員主控台API&服務儀表板，然後按一下[選取專案]。

按一下專案名稱，或按一下[新增專案]，以建立新的專案： 如果您已建立新專案，請在顯示的[新增Project]對話方塊中輸入專案名稱。

此對話方塊會根據專案名稱製造唯一的專案識別碼。

接下來，按一下[建立]按鈕，如下列範例所示： 在一分鐘之後，系統會建立專案，並帶您前往專案的[儀表板]頁面。

從該處按一下[啟用API和服務]： 從[API程式庫]頁面中，按一下[適用于Android的SDK]地圖。

在下一個頁面上，按一下[啟用]以開啟此專案的服務： 此時已建立API專案，且已將Google地圖AndroidAPIv2新增至該專案。

不過，在為您的專案建立認證之前，您無法在專案中使用此API。

下一節說明如何建立API金鑰，並授權Xamarin.Android應用程式使用此金鑰。

取得API金鑰 建立Google開發人員主控台API專案之後，必須建立AndroidAPI金鑰。

Xamarin.Android應用程式必須先有API金鑰，才能獲得Android地圖APIv2的存取權。

在按一下上一個步驟中的[啟用])之後，(顯示的[適用于Android的地圖SDK]頁面中，移至[認證]索引標籤，然後按一下[建立認證]按鈕： 按一下[API金鑰]： 按一下此按鈕之後，就會產生API金鑰。

接下來，您必須限制此金鑰，以便只有您的應用程式可以使用此金鑰呼叫API。

按一下[限制金鑰]： 將[名稱]欄位從API金鑰1變更為名稱，以協助您記住(XamarinMapsDemoKey所使用的金鑰，在此範例中)。

接下來，按一下[Android應用程式]選項按鈕： 若要新增SHA-1指紋，請按一下[+新增套件名稱和指紋]： 輸入應用程式的套件名稱，並輸入透過取得keytool的SHA-1憑證指紋(，如本指南稍早所述)。

在下列範例中，會輸入的XamarinMapsDemo套件名稱，後面接著從debug.keystore取得的SHA-1憑證指紋： 請注意，為了讓APK能夠存取Google地圖，您必須針對每個金鑰存放區包含SHA-1指紋和套件名稱，(偵錯和發行)您用來簽署APK。

例如，如果您使用一部電腦進行偵錯，而另一部電腦產生發行APK，則應該從第一部電腦的偵錯金鑰存放區包含SHA-1憑證指紋，以及第二部電腦的發行金鑰存放區中的SHA-1憑證指紋。

按一下[+新增套件名稱和指紋]以新增另一個指紋和套件名稱，如下列範例所示： 按一下[儲存]按鈕以儲存您的變更。

接下來，您會返回API金鑰清單。

如果您有稍早建立的其他API金鑰，也會列在這裡。

在此範例中，只會列出先前步驟中建立的一個API金鑰()： 將專案連線至計費帳戶 從2018年6月11日開始，如果專案未連線到計費帳戶，API金鑰將無法運作(即使服務仍然免費供行動應用程式使用)也一樣。

按一下漢堡功能表按鈕，然後選取[帳單]頁面： 按一下[連結計費帳戶]，然後按一下顯示的快顯(上的[建立計費帳戶]，將專案連結至計費帳戶，系統會引導您建立新的帳戶)： 將金鑰新增至您的Project 最後，將此API金鑰新增至Xamarin.Android應用程式的AndroidManifest.XML檔案。

在下列範例中，YOUR_API_KEY會取代為先前步驟中產生的API金鑰： ... 相關連結 GoogleAPI主控台 Google地圖API金鑰 keytool 本文內容