事前準備
您必須擁有已連結帳單帳戶的專案,才能開始使用 Places SDK for iOS Places SDK for iOS 已啟用。請參閱這篇文章,進一步瞭解如何在 Cloud 控制台完成相關設定。
建立 API 金鑰
API 金鑰是一組專屬 ID,用於驗證與您專案有關的使用權限及帳單處理請求。您的專案至少要有一個相關聯的 API 金鑰。
建立 API 金鑰的方法如下:
控制台
-
前往「Google Maps Platform」(Google 地圖平台) >「Credentials」(憑證) 頁面。
-
在「Credentials」(憑證) 頁面上,點選「Create credentials」(建立憑證) >「API key」(API 金鑰)。
「API key created」(建立的 API 金鑰) 對話方塊會顯示您新建立的 API 金鑰。 -
按一下「Close」(關閉)。
新建立的 API 金鑰會出現在「Credentials」(憑證) 頁面的「API keys」(API 金鑰) 下方。
(別忘了先為 API 金鑰設定限制,然後才在正式環境中使用)
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令:
,瞭解如何調查及移除這項存取權。限制 API 金鑰
Google 強烈建議您設定限制,只允許將 API 金鑰用於應用程式需要的 API。限制 API 金鑰可避免不必要的請求使用 API 金鑰,有助提升應用程式的安全性。詳情請參閱「API 安全性最佳做法」。
限制 API 金鑰的方法如下:
控制台
-
前往「Google Maps Platform」(Google 地圖平台) >「Credentials」(憑證) 頁面。
- 選取要設定限制的 API 金鑰,畫面隨即顯示 API 金鑰屬性頁面。
- 在「Key restrictions」(金鑰限制) 下方,設定下列限制:
- 應用程式限制:
- 選取 [iOS 應用程式]。
- 如要接受含有您所輸入軟體包 ID 的 iOS 應用程式所發出的要求,請按照下列步驟操作: 請從清單中選取適當的 iOS 軟體包 ID。
- API 限制:
- 按一下 [限制金鑰]。
- 從「選取 API」下拉式選單中選取「Places API」。 如果選單未列出 Places API,則 啟用。
- 如要完成變更,請按一下 [儲存]。
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="places-backend.googleapis.com" --allowed-bundle-ids="BUNDLE_NAME"
進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令: