設定

本頁面說明如何完成設定，開始使用 Maps 3D SDK for iOS 建構。設定程序包括設定 Google Cloud 雲端專案和 API，以便與 SDK 搭配使用，然後設定 Xcode 專案。請先完成這些步驟，再將第一張 3D 地圖新增至應用程式。

必要條件

如要使用 Maps 3D SDK for iOS，專案和目標裝置必須符合下列需求：

• 最低 iOS 版本：指定 iOS 16.0 以上版本。
• Xcode：Xcode 16.0 以上版本。

設定 Google Cloud 雲端專案和 API 金鑰

您必須先設定 Google Cloud 雲端專案和 API 金鑰，才能開始使用 Maps 3D SDK for iOS 建構內容。請完成下列步驟：

步驟 1：設定專案

控制台

1. 在 Google Cloud 控制台的專案選取器頁面中，按一下「建立專案」，開始建立新的 Cloud 專案。

   前往專案選取器頁面

2. 確認 Cloud 專案已啟用計費功能。 確認專案已啟用計費功能。

   Google Cloud 提供免付費試用期。試用期將於 90 天後或帳戶費用累積達 $300 美元時 (以先發生者為準) 結束。您隨時可以取消試用。詳情請參閱「帳單帳戶抵免額」和「帳單」。

Cloud SDK

gcloud projects create "PROJECT"

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

• gcloud projects create

注意：如果您不打算保留練習期間建立的資源，請建立新專案，不要選取現有專案。這樣當您完成練習後，就可以直接刪除該專案，並移除相關聯的所有資源。

步驟 2：啟用 API 或 SDK

如要使用 Google 地圖平台，請啟用打算在專案中使用的 API 或 SDK。

請注意，有些整合需要您啟用多個 API/SDK。如果不確定要啟用哪些 API 或 SDK，請嘗試使用功能探索工具，或查詢要使用的 API/SDK 專用說明文件。

如要啟用一或多個 API 或 SDK，請按照下列步驟進行：

控制台

1. 請前往 Cloud 控制台的「Maps API 程式庫」頁面，查看您可以啟用的 Google Maps Platform API 和 SDK：

   前往 Maps API 程式庫頁面

2. 按一下您要啟用的 API 或 SDK。
   • 如果按鈕顯示「啟用」，請按一下按鈕啟用該 API 或 SDK。
   • 如果按鈕顯示「管理」，表示 API 或 SDK 已啟用，您不需要再採取任何動作。
   • 按一下上述其中一個按鈕，畫面隨即會顯示該 API 或 SDK 的資訊主頁 (按一下「停用」按鈕，即可將該 API 或 SDK 從這個專案中移除)。

Cloud SDK

下列指令會啟用所有 Maps、Routes 和 Places API：

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

• gcloud services enable
• gcloud services disable

使用下列指令啟用 Environment API：

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

注意：啟用 Places API 也會同時啟用 Places Library、Maps JavaScript API、Places SDK for Android 和 Places SDK for iOS。

步驟 3：取得 API 金鑰

此步驟僅適用 API 金鑰建立程序。若您在正式環境中使用 API 金鑰，強烈建議您為 API 金鑰設定限制。詳情請參閱特定產品的「使用 API 金鑰」頁面。

API 金鑰是一組專屬 ID，用於驗證與您專案有關的使用權限及帳單處理要求。您的專案至少要有一個相關聯的 API 金鑰。 如要建立新金鑰，或將 API/SDK 新增至現有金鑰，請按照下列操作說明進行。

控制台

1. 前往「Google Maps Platform」>「金鑰和憑證」頁面。

   前往「Keys & Credentials」(金鑰和憑證) 頁面

2. 如果出現系統提示，請選取您的專案。

3. 請執行下列任一步驟：

   • 建立新金鑰：

     1. 依序按一下 [Create credentials] (建立憑證) > [API key] (API 金鑰)。
     2. 在「建立 API 金鑰」面板中，開啟「選取 API 限制」清單。
     3. 清除這組金鑰不需要的所有 API，並確認您要使用的 API 仍處於選取狀態。
     4. 按一下「建立」，面板會顯示新的 API 金鑰。

   • 使用現有金鑰：

     1. 按一下金鑰名稱。
     2. 在「選取 API 限制」清單中，選取要使用的 API。
     3. 按一下 [儲存]。

   在這裡選取 API 並不會啟用該 API。請確認您選取的每個 API 都已在 API 程式庫中啟用。

4. 如要日後查看金鑰字串，請前往「金鑰和憑證」頁面，然後按一下金鑰的「顯示金鑰」。

如果控制台與這些步驟不同，請參閱 Google Cloud 說明文件中的「建立 API 金鑰」和「新增 API 限制」。

Cloud SDK

在下列指令中，將 PROJECT_ID 替換為您的專案 ID。

• 建立新金鑰：執行下列指令，並將 DISPLAY_NAME 替換為金鑰名稱。將 SERVICE_NAME 替換成您要使用的 API 服務名稱，例如 places.googleapis.com。如要允許更多 API，請重複 --api-target 旗標。

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=SERVICE_NAME

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

  • gcloud services api-keys create

• 使用現有金鑰：執行下列指令，並將 KEY_ID 替換為金鑰 ID。將 SERVICE_NAME 替換為要新增的 API 服務名稱。--append 旗標會保留金鑰已允許的 API。如果沒有這項參數，指令會替換這些執行個體。

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=SERVICE_NAME

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  金鑰 ID 不是金鑰字串或顯示名稱。如要找出這個值，請執行 gcloud services api-keys list --project="PROJECT_ID"。ID 是 name 欄位的最後一部分：projects/PROJECT_NUMBER/locations/global/keys/KEY_ID。

如要查看金鑰字串，請執行 gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID"。

如要啟用 SDK，請前往 Google Cloud 控制台的 Maps 3D SDK for iOS 頁面。如要進一步瞭解如何完成這些步驟，請參閱「開始使用 Google 地圖平台」。

設定 Xcode 專案

本節說明如何建立及設定 Xcode 專案，以便與 Maps 3D SDK for iOS 搭配使用。

啟用計費功能並建立 API 金鑰後，即可設定要用來開發應用程式的 Xcode 專案。

步驟 1：安裝必要軟體

如要使用 Maps 3D SDK for iOS 建立專案，請下載並安裝：

• Xcode 16.0 以上版本

步驟 2：建立 Xcode 專案並安裝 Maps 3D SDK for iOS

Swift Package Manager

您可以使用 Swift Package Manager 安裝 Maps 3D SDK for iOS。

如要將 SDK 新增至新專案或現有專案，請按照下列步驟操作：

• 開啟 Xcode project 或 workspace，然後依序前往「File」 >「Add Package Dependencies」。
• 輸入 https://github.com/googlemaps/ios-maps-3d-sdk 做為網址，按下 Enter 鍵擷取套件，然後按一下「Add Package」。
• 在「Choose Package Products」視窗中，確認 GoogleMaps3D 會新增至指定的主要目標。完成後，按一下「新增套件」。
• 如要驗證安裝，請前往目標的「General」窗格。在「Frameworks, Libraries, and Embedded Content」中，您應該會看到已安裝的套件。您也可以查看「Project Navigator」的「Package Dependencies」部分，確認套件及其版本。

步驟 3：在應用程式中加入 API 金鑰

Swift Package Manager

請按照下列步驟，將 API 金鑰新增至應用程式的主要進入點 (或地圖載入前的任何時間點)。

1. 新增下列匯入陳述式：

   import GoogleMaps3D

2. 新增下列方法。然後將 YOUR_API_KEY 替換成您的 API 金鑰。

   struct ContentView: View {
     init () {
       Map.apiKey = "YOUR_API_KEY"
     }
   
     var body: some View {
       Map(mode: .hybrid)
     }
   }
       

API 金鑰可以顯示在應用程式的進入點，也可以分別顯示在各個地圖檢視畫面。

不過，如果同時在進入點和地圖檢視中指定 API 金鑰，控制台就會產生錯誤。

步驟 4 (選用)：檢查 Apple 隱私權資訊清單檔案

注意： 以下內容與將應用程式部署至線上應用程式商店有關。

Apple 規定，在 App Store 上架的應用程式必須提供隱私權詳細資料。

Apple 隱私權資訊清單檔案包含在 SDK 的資源套件中。如要確認是否已加入隱私權資訊清單檔案，並檢查其內容，請建立應用程式封存檔，並從封存檔產生隱私權報告。

後續步驟

您已設定好 Google Cloud 雲端專案、API 金鑰和 Xcode 專案，可搭配 Maps 3D SDK for iOS 使用，現在可以在應用程式中加入 3D 地圖。