取得 API 金鑰

選取平台： Android iOS JavaScript

設定帳單與專案、啟用 SDK 並安裝偏好的依附元件管理工具和其他軟體後，您就可以開始建立、新增及限制 API 金鑰了。

建立 API 金鑰

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

建立 API 金鑰的方法如下：

控制台

前往「Google 地圖平台」>「憑證」頁面。

前往「憑證」頁面
在「憑證」頁面上，點選「建立憑證」>「API 金鑰」。
「建立的 API 金鑰」對話方塊會顯示您新建立的 API 金鑰。
按一下「關閉」。
新建立的 API 金鑰會出現在「憑證」頁面的「API 金鑰」下方。
(別忘了先為 API 金鑰設定限制，然後才在實際工作環境中使用。)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令：

gcloud alpha services api-keys create

當您建立 Xcode 專案時，需使用這個 API 金鑰，如設定 Xcode 專案一節所述。

限制 API 金鑰

Google 強烈建議您設定限制，只允許將 API 金鑰用於應用程式需要的 API。限制 API 金鑰可避免不必要的請求使用 API 金鑰，有助提升應用程式的安全性。詳情請參閱「API 安全性最佳做法」。

限制 API 金鑰的方法如下：

控制台

前往「Google 地圖平台」>「憑證」頁面。

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

應用程式限制：

選取 [iOS 應用程式]。
如要接受來自您提供的軟體包 ID 的 iOS 應用程式請求，請從清單中選取適當的 iOS 軟體包 ID。

API 限制：

按一下 [限制金鑰]。
從「選取 API」下拉式選單中點選 [Maps SDK for iOS]。如果畫面上未列出 Maps SDK for iOS，表示您需要啟用該 SDK。

如要完成變更，請按一下 [儲存]。

Cloud SDK

列出現有金鑰。

gcloud services api-keys list --project="PROJECT"

清除現有金鑰的目前限制。

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

為現有金鑰設定新限制。

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api_target="maps-ios-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令：

取得 Maps SDK for iOS 的 API 金鑰後，您就可以開始使用。

後續步驟

取得 API 金鑰後，接下來請按照「設定 Xcode 專案」一文中的說明來建立及設定您的 Xcode 專案。