Maps SDK for iOS:取得 API 金鑰

注意事項:Google 地圖平台付費方案不再開放註冊或提供給新客戶。

如要使用 Maps SDK for iOS,您必須擁有 API 金鑰。API 金鑰是一組專屬 ID,用來驗證與專案相關的使用權限與帳單處理要求。

建立 API 金鑰

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

取得 API 金鑰的方法如下:

  1. 前往 Google Cloud Console
  2. 按一下專案下拉式選單,然後選取您購買付費方案時建立的專案。專案名稱開頭為 Google Maps API for Business 或 Google Maps for Work 或 Google Maps
  3. 注意事項:如要使用方案的完整功能,付費客戶應使用與付費帳戶連結的專案。購買授權後,您會收到以下列格式編寫的付費資產名稱:gme-[company] & proj-[number] ([type])。為確保您存取的是正確的專案,請透過 console.cloud.google.com/project/number (將 number 替換成專案編號) 以「專案擁有者身分」登入 Cloud Console。您可以在歡迎信中查看專案擁有者是誰。

  4. 按一下選單按鈕 ,然後選取 [API 和服務] > [憑證]
  5. 在「憑證」頁面上,按一下 [建立憑證] > [API 金鑰]
    「建立的 API 金鑰」對話方塊會顯示新建立的 API 金鑰 (加密字串)。
  6. 按一下 [關閉]
    新建立的 API 金鑰便會出現在「憑證」頁面的「API 金鑰」下方。

在應用程式中加入 API 金鑰

請將以下範例中的 YOUR_API_KEY 替換成您的 API 金鑰。

Swift

將 API 金鑰新增到您的 AppDelegate.swift 中,如下所示:

  1. 新增下列匯入陳述式:
    import GoogleMaps
  2. 將以下內容新增到您的 application(_:didFinishLaunchingWithOptions:) 方法中,並以您的 API 金鑰取代「YOUR_API_KEY」
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. 如果您也使用 Places API,請再次新增金鑰,如下所示:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

將 API 金鑰新增到您的 AppDelegate.m 中,如下所示:

  1. 新增下列匯入陳述式:
    @import GoogleMaps;
  2. 將以下內容新增到您的 application:didFinishLaunchingWithOptions: 方法中,並以您的 API 金鑰取代「YOUR_API_KEY」
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. 如果您也使用 Places API,請再次新增金鑰,如下所示:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

限制 API 金鑰

限制 API 金鑰可確保只有經授權的要求才能使用 API 金鑰,進而提升您應用程式的安全性。我們極力建議您按照操作說明設定 API 金鑰的限制。詳情請參閱 API 金鑰最佳做法

限制 API 金鑰的方法如下:

  1. 在 Cloud Console 的專案選取器頁面中,選取或建立您想新增 API 金鑰的 Google Cloud 專案。

    前往專案選取器頁面

  2. 前往「API 和服務」>「憑證」頁面。

    前往憑證頁面

  3. 選取要設定限制的 API 金鑰,畫面隨即顯示 API 金鑰屬性頁面。
  4. 在「金鑰限制」下方,設定下列限制:
    • 應用程式限制:
      1. 選取 [iOS 應用程式]
      2. 如要接受來自您提供的 iOS 應用程式軟體包 ID 提出的要求,請從清單中選取適當的 iOS 軟體包 ID。
    • API 限制:
      1. 按一下 [限制金鑰]
      2. 從「選取 API」下拉式選單中選取 [Maps SDK for iOS]
        (如果畫面上未列出 Maps SDK for iOS,您必須先啟用該 SDK)。
  5. 如要完成變更,請按一下 [儲存]