您已全部設定完成!

若要開始開發,請參閱我們的開發人員文件

啟用 Google Maps Android API

為協助您開始,我們將先引導您使用 Google Developers Console 來執行一些動作:

  1. 建立或選擇專案
  2. 啟用 Google Maps Android API
  3. 建立適當的金鑰
繼續

取得 API 金鑰

如果要使用 Google Maps Android API,您必須在 Google API Console 上註冊您的應用程式專案,然後取得可新增至您應用程式的 Google API 金鑰。

注意: API 金鑰有各種類型的限制。 您需要具有針對 Android 應用程式限制的 API 金鑰(不是瀏覽器限制的金鑰)。

取得金鑰的快速指南

步驟 1. 從 Google API Console 取得 API 金鑰

請按一下下方按鈕,它將引導您完成程序,並自動啟動 Google Maps Android API。

取得金鑰

注意:

  • 針對 Google Maps APIs Premium Plan 客戶:當您看到專案的下拉式選單時,必須選取訂購 Google Maps APIs Premium Plan 時,系統為您建立的專案。專案名稱將會以 Google Maps APIs for Business or Google Maps for Work or Google Maps 做為開頭。
  • 如果想要購買 Premium Plan 授權,請與銷售人員聯絡
  • 針對測試用途,可以建立所有平台皆適用的一般且不受限制的 API 金鑰。為了在進入生產之前確保金鑰安全,您必須限制金鑰如下所述。

步驟 2. 將 API 金鑰新增到您的應用程式

依照下面的步驟在您應用程式的宣示說明 (包含在檔案 AndroidManifest.xml 內) 中包括 API 金鑰。

  1. AndroidManifest.xml 中,將下列元素新增為 <application> 元素的子項,方式是透過在結尾的 </application> 標籤前面插入該元素:
        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
        

    以您的 API 金鑰替代 value 屬性中的 YOUR_API_KEY。此元素會將金鑰 com.google.android.geo.API_KEY 設定為您的 API 金鑰值。

  2. 儲存 AndroidManifest.xml 並重新建置您的應用程式。

注意:如上所示,建議使用 com.google.android.geo.API_KEY 做為 API 金鑰的中繼資料名稱。名稱如上的金鑰可用來驗證 Android 平台上的多個 Google 地圖型 API,包括 Google Maps Android API。為提供回溯相容性,API 也支援名稱 com.google.android.maps.v2.API_KEY。此舊版名稱只能向 Android Maps API v2 驗證。應用程式只能指定這些 API 金鑰中繼資料名稱的其中一個。如果同時指定兩者,API 會擲回例外狀況。

這樣就行了!如果您成功遵循上述步驟,那就完成了。如果碰到問題,請參閱下列有關標準 APIPremium Plan 的詳細操作說明。

取得 API 金鑰的詳細指南。

標準版 Google Maps Android API 使用者的詳細指南

如果按下按鈕並未前往應該出現的頁面,可以依照這些替代步驟來取得 API 金鑰:

  1. 前往 Google API Console
  2. 建立或選取專案。
  3. 按一下 [Continue] 以啟用 Google Maps Android API。
  4. 憑證 頁面上,取得 API 金鑰
    注意:如果您有現有的 Android 限制 API 金鑰,則可以使用該金鑰。
  5. 在顯示 API 金鑰的對話方塊中,選擇 [Restrict key] 以設定 API 金鑰上的 Android 限制。
  6. 在 [Restrictions] 區塊中,選擇 [Android apps],然後輸入應用程式的 SHA-1 指紋與套件名稱。例如:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
  7. 請參閱下面的深入了解 API 金鑰限制
  8. 按一下 [Save]

您的新 Android 限定 API 金鑰會出現在您專案的 API 金鑰清單中。API 金鑰是字元字串,類似於:

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Google Maps APIs Premium Plan 授權使用者的詳細指南

如果按下按鈕並未前往應該出現的頁面,可以依照這些替代步驟來取得 API 金鑰:

  1. 前往 Google API Console
  2. 從專案的下拉式選單中,選取 Google Maps Premium 專案。*
  3. 按一下 [Continue]
  4. 憑證 頁面上,取得 API 金鑰
  5. 在顯示 API 金鑰的對話方塊中,選擇 [Restrict key] 以設定 API 金鑰上的 Android 限制。
  6. 在 [Restrictions] 區塊中,選擇 [Android apps],然後輸入應用程式的 SHA-1 指紋與套件名稱。例如:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
    請參閱下面的深入了解 API 金鑰限制
  7. 按一下 [Save]

您的新 Android 限定 API 金鑰會出現在您專案的 API 金鑰清單中。API 金鑰是字元字串,類似於:

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

深入了解 Google API Console

您也可以在 Google API Console 中查詢現有金鑰

如需有關使用 Google API Console 的詳細資訊,請參閱 API Console 說明

深入了解 API 金鑰限制

Google Maps API 適用於 Android 或 iOS 應用程式、網頁瀏覽器,而且可透過 HTTP Web 服務使用。任何平台上的 API 都可以使用一般(不受限制)API 金鑰。您可以選擇性地新增限制。針對 Android 應用程式,您要將金鑰限制在應用程式的 SHA-1 指紋與套件名稱。受限制的金鑰只能在支援該類型限制的平台上運作。

到哪裡取得應用程式的 SHA-1 指紋

Android API 金鑰限制是以您應用程式數位憑證的簡短形式為依據,也就是憑證的 SHA-1 指紋

從 Android Studio 取得認證資訊

如果您遵照 Google Maps Android API 入門指南,Android Studio 會使用您應用程式的憑證,建立方便的 google_maps_api.xml 檔案。

選擇下列其中一種方式從 Android Studio 取得您的 API 金鑰:

  • 最快速、簡單的方式:使用 Android Studio 為您建立的 google_maps_api.xml 檔案中提供的連結:
    1. 複製 google_maps_api.xml 檔案中提供的連結,然後在您的瀏覽器中貼上。該連結會帶您前往 Google API Console,並透過 URL 參數提供前往 Google API Console 的必要資訊,進而減少需要您手動輸入的次數。
    2. 依照指示在 Google API Console 上建立新的專案,或選取現有的專案。
    3. 為您的專案建立 Android 限定 API 金鑰。
    4. 複製產生的 API 金鑰,返回 Android Studio,然後將 API 金鑰黏貼到 google_maps_api.xml 檔案中的 <string> 元素。
  • 稍微慢一點的方式:使用 Android Studio 為您建立的 google_maps_api.xml 檔案中提供的憑證:
    1. 複製 google_maps_api.xml 檔案中提供的憑證。
    2. 在您的瀏覽器中前往 Google API Console
    3. 使用複製的憑證,將您的應用程式新增至現有的 API 金鑰,或建立新的 API 金鑰。

自行取得憑證資訊

如果您在建立應用程式時,未遵照入門指南,那麼您必須自行取得憑證的 SHA-1 指紋。首先,請確認您使用的是正確的憑證。您可能會有兩個憑證:

  • 偵錯憑證:Android SDK 工具會在您執行偵錯建置時自動產生此憑證。此憑證只能搭配您要測試的應用程式使用。請不要嘗試發佈使用偵錯憑證簽署的應用程式。在 Android 開發人員文件中的在偵錯模式中簽署對偵錯憑證有更詳細的說明。
  • 發行憑證:Android SDK 工具會在您執行發行建置時自動產生此憑證。您也可以使用 keytool 程式產生此憑證。請在您準備好在市場上公開發行應用程式時,才使用此憑證。

如果要顯示憑證的 SHA-1 指紋,請依照下列步驟,使用 keytool 程式搭配 -v 參數。如需有關 Keytool 的詳細資訊,請參閱 Oracle 文件

偵錯憑證

顯示偵錯憑證指紋

  1. 找出您的偵錯金鑰存放區檔案。檔案名稱為 debug.keystore,而且是在您第一次建置專案時建立。它預設會儲存在與 Android Virtual Device (AVD) 檔案相同的目錄:

    • macOS 與 Linux~/.android/
    • Windows Vista 與 Windows 7C:\Users\your_user_name\.android\
  2. 列出 SHA-1 指紋:

    • 對於 Linux 或 macOS,請開啟終端機視窗並輸入下列命令:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • 對於 Windows Vista 與 Windows 7,請執行:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

您應該會看見類似下面的輸出:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     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
     Signature algorithm name: SHA1withRSA
     Version: 3
發行憑證

顯示發行憑證指紋

  1. 找出您的發行憑證金鑰存放區檔案。發行金鑰存放區並沒有預設的位置或名稱。如果您在建置供發行用的應用程式時沒有指定發行金鑰存放區,則該版本會讓您的 .apk 維持未簽署的狀態,您必須先將它簽署才能發佈。對於發行憑證,您還需要憑證的別名,以及金鑰存放區與憑證的密碼。您可以透過輸入下列命令,以列出金鑰存放區中所有金鑰的別名:

    keytool -list -keystore your_keystore_name

    your_keystore_name 取代為金鑰存放區的完整路徑與名稱,包括 .keystore 副檔名。接著會提示您輸入金鑰存放區的密碼。然後 keytool 就會顯示金鑰存放區中的所有別名。

  2. 在終端機或命令提示字元中輸入下列命令:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    your_keystore_name 取代為金鑰存放區的完整路徑與名稱,包括 .keystore 副檔名。將 your_alias_name 取代為您建立憑證時指派給憑證的別名。

您應該會看見類似下面的輸出:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1 為開頭的那一行包含憑證的 SHA-1 指紋。指紋是以冒號分隔的 20 個兩位數十六進位數字序列。

請參閱簽署應用程式的 Android 指南,瞭解有關數位憑證的進一步資訊。

傳送您對下列選項的寶貴意見...

這個網頁
Google Maps Android API
Google Maps Android API
需要協助嗎?請前往我們的支援網頁