設定和示範

使用 Swift Package Manager

1. 如果您尚未建立 Xcode 專案，請立即建立專案，並儲存至本機電腦。 (如果您是 iOS 開發新手，請建立新專案並選取「iOS 應用程式」 範本在 Xcode 11.7 以下版本，建立 Single View Application。
2. 新增 Maps SDK for iOS 做為依附元件。詳情請見 安裝 SDK 以查看相關選項。
3. 在 Xcode 專案中瀏覽至 [File] (檔案) ->快速套票 ->新增套件依附元件。
4. 在顯示的視窗中，輸入 Maps SDK for iOS 公用程式庫存放區網址 https://github.com/googlemaps/google-maps-ios-utils，然後選取「Next」(下一步)。
• 此時，系統可能會提示您使用 GitHub 帳戶進行驗證。跟著 指示 GitHub 個人存取權杖，才能繼續完成這個程序。
5. 在下一個視窗中選取「版本」圓形按鈕，然後選取「到下一個主要版本」 ，然後輸入最新版的 Maps SDK for iOS 公用程式庫版本。 (例如「6.0.0」)。
6. 按一下「Add to Project」旁的下拉式選單，選取專案，然後選取「Add Package」。

使用 CocoaPods

1. 如果還沒有 Xcode 專案，請立即建立並儲存到 本機電腦(如果您是 iOS 開發新手，請建立「單一」 查看「申請」)。
2. 如果您的專案還沒有 Pod 檔案，請建立檔案 名為 Podfile。這個檔案定義了 專案的依附元件
3. 編輯專案的 Pod 檔案，並在 Google-Maps-iOS-Utils 個廣告連播。以下是 包含應用程式所需的依附元件 Maps SDK for iOS 和公用程式庫：

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version
   end

4. 執行 pod install。
5. 關閉 Xcode，然後開啟 (連按兩下) 來 .xcworkspace 檔案可啟動 Xcode。從現在開始 必須使用 .xcworkspace 檔案開啟專案。

注意：標記叢集公用程式取決於 但無須標記叢集即可使用 Quadtree。如果您希望 在這個例子中， pod 'Google-Maps-iOS-Utils'到 'Google-Maps-iOS-Utils/QuadTree'。

使用 GitHub 中的檔案

1. 下載 程式碼範例封存區 GitHub 並將封存檔解壓縮。
2. 開啟終端機視窗，前往您展開範例檔案的目錄，然後 細查您要使用的語言範例目錄：
   • 如果是 Swift，請執行 cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • 如為 Objective-C，請執行 cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. 執行下列指令：
   

   pod install

4. 關閉 Xcode，然後開啟 (連按兩下) 來 .xcworkspace 檔案可啟動 Xcode。從現在開始 必須使用 .xcworkspace 檔案開啟專案。

使用 CocoaPods v1.6.1

1. 開啟終端機視窗並安裝 1.6.1 版：

   sudo gem install cocoapods -v1.6.1

2. 使用 Cocoapods 擷取 Google 地圖檔案：

   pod try Google-Maps-iOS-Utils

   系統提示時，請選擇 Swift 或 Objective-C。CocoaPods 會更新規格存放區 然後在名為 SwiftDemoApp.xcodeproj 的臨時 Xcode 專案中開啟示範內容 或 ObjCDemoApp.xcodeproj。

Swift

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

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

   import GoogleMaps

2. 您可以編輯下列程式碼，在雙引號之間新增 API 金鑰：

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

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

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

   @import GoogleMaps;

2. 您可以編輯下列程式碼，在雙引號之間新增 API 金鑰：

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";