設定

這項產品或功能仍在實驗階段 (正式發布前)。 我們對於正式發布前的產品和功能僅提供有限度的支援。此外，這類產品和功能的變更可能與其他正式發布前版本不相容。正式發布前產品/功能受到《Google 地圖平台服務專屬條款》規範。詳情請參閱推出階段說明。

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

設定 Google Cloud 專案和 API 金鑰

開始使用 Maps 3D SDK for iOS 建構應用程式前，請先完成下列步驟，設定 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

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

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

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

控制台

1. 請前往 Cloud 控制台的「Maps API 程式庫」頁面，查看您可以啟用的 Google 地圖平台 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 金鑰是一組專屬 ID，用於驗證與您專案有關的使用權限及帳單處理要求。您的專案至少要有一個相關聯的 API 金鑰。

建立 API 金鑰的方法如下：

控制台

1. 前往「Google Maps Platform」(Google 地圖平台) >「Credentials」(憑證) 頁面。

   前往「Credentials」(憑證) 頁面

2. 在「Credentials」(憑證) 頁面上，點選「Create credentials」(建立憑證) >「API key」(API 金鑰)。
   「API key created」(建立的 API 金鑰) 對話方塊會顯示您新建立的 API 金鑰。
3. 按一下「Close」(關閉)。
   新建立的 API 金鑰會出現在「Credentials」(憑證) 頁面的「API keys」(API 金鑰) 下方。
   (別忘了先為 API 金鑰設定限制，然後才在正式環境中使用)

Cloud SDK

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

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

• gcloud services api-keys create

如要啟用 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」(新增套件)。
• 在「選擇套裝產品」視窗中，確認 GoogleMaps3D 將新增至指定的主要目標。完成後，按一下「新增套裝組合」。
• 如要驗證安裝作業，請前往目標的「一般」窗格。在「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 地圖新增至應用程式。