設定和示範

選取平台： Android iOS

本頁面說明 Maps SDK for iOS 的公用程式庫設定方式。

如要嘗試這些公用程式，您可以採用下列其中一種做法：

• 安裝並執行試用版應用程式。試用版應用程式是獨立專案，其中包含試用公用程式所需的所有程式碼。
• 將公用程式程式庫安裝至現有的 Xcode 專案。在自己的專案中新增這些公用程式。

選用安裝 CocoaPods

公用程式程式庫是以名為 Google-Maps-iOS-Utils 的 CocoaPods Pod 的形式提供。CocoaPods 是 Swift 和 Objective-C Cocoa 專案的開放原始碼依附元件管理員。

如果您還沒有 CocoaPods 工具，請在終端機中執行下列指令，以便在 macOS 中安裝：

sudo gem install cocoapods

詳情請參閱 CocoaPods 入門指南。

安裝並執行試用版應用程式

公用程式庫內含一個試用版應用程式，您可以安裝此應用程式並進行試用。

在 CocoaPods 1.8.1 以上版本中，有 'pod try' 的已知問題。如要使用 CocoaPods 擷取檔案，建議使用 CocoaPods 1.6.1 版。或者，您也可以從 GitHub 下載範例檔案。

請使用下列其中一種方法安裝試用版應用程式：

使用 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 或 ObjCDemoApp.xcodeproj 的臨時 Xcode 專案中開啟示範模式。

在試用版應用程式中新增 API 金鑰

在「取得 API 金鑰」中，為應用程式產生 API 金鑰。現在，請將該金鑰加入試用版應用程式的 Xcode 專案。

注意：如果您的 API 金鑰使用應用程式限制，請務必將應用程式的套件 ID 新增至金鑰。舉例來說，如果您執行試用版應用程式，則套件 ID 為 com.google.gmsutils.DemoApp。如要進一步瞭解如何限制金鑰，請參閱取得 API 金鑰。

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 = @"";

建構並執行試用版應用程式

新增 API 金鑰後，請建構並執行專案：

• 如果您執行的是 Swift 版本的示範版本，可以在應用程式中選擇要查看的公用程式。
• 如果您執行示範的 Objective-C 版本，就會看到標記叢集公用程式的示範。接著，您可以編輯示範的 Objective-C 版本以試用每個公用程式。 詳情請參閱下方的為應用程式新增公用程式一節。

以 Xcode 專案形式安裝公用程式庫

請按照下列步驟將公用程式庫加入 Xcode 工作區：

使用 CocoaPods

1. 如果您還沒有 Xcode 專案，請立即建立專案並儲存至本機電腦。(如果你是 iOS 開發新手，請建立單一檢視畫面應用程式)。
2. 如果專案沒有 Pod 檔案，請在專案目錄中建立名為 Podfile 的檔案。這個檔案定義了專案的依附元件。
3. 編輯專案的 Pod 檔案，並在 Google-Maps-iOS-Utils Pod 中新增依附元件。以下範例包含 Maps SDK for iOS 所需的依附元件和公用程式庫：

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '13.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '7.4.0'
     pod 'Google-Maps-iOS-Utils', '4.1.0'
   end

4. 執行 pod install。
5. 關閉 Xcode，然後開啟專案 .xcworkspace 的檔案 (按兩下) 即可啟動 Xcode。從現在起，您必須使用 .xcworkspace 檔案才能開啟專案。

注意：標記叢集公用程式取決於 quadtree，但您可以使用 quadtree 而不使用標記叢集。如果您只想使用 quadtree 公用程式，可以在廣告連播檔案中將 pod 'Google-Maps-iOS-Utils' 變更為 'Google-Maps-iOS-Utils/QuadTree'。

使用基地台

1. 安裝 Carthage。存在的方法有很多，因此請參閱 Carthage README 檔案，瞭解實際步驟。
2. 如果您還沒有 Xcode 專案，請立即建立一個並儲存至本機電腦 (如果您是 iOS 開發新手，請建立新專案，並選取 [iOS App template])。在 Xcode 11.7 版或更舊版本中，建立 Single View Application。
3. 在專案目錄中建立名為 Cartfile 的檔案。這個檔案定義了專案的依附元件。
4. 編輯 Cartfile 並新增 Maps SDK for iOS 公用程式庫依附元件：
   

   github "googlemaps/google-maps-ios-utils"

5. 儲存 Cartfile。
6. 在終端機視窗中，前往含有 Cartfile 的目錄：
   

   cd <path-to-project>

7. 執行更新指令：
   

   carthage update --platform iOS

   
   這會安裝 Cartfile 中指定的 API 及其所有依附元件。
8. 在 Finder 的專案目錄中，前往 Carthage/Build/iOS 下下載的架構檔案。
9. 將下列套件拖曳至專案中，以便將 Maps SDK for iOS 架構新增至專案。(系統顯示提示時，請選取 [視需要複製項目，請使用與上述版本相同的版本])。
   • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
   付費方案客戶也必須包含 GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework。
10. 以滑鼠右鍵按一下專案中的 GoogleMaps.framework，然後選取 [Show in Finder]。
11. 將 Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle 從 Resources 資料夾拖曳至專案中。畫面顯示提示時，請確保您並未選取 [Copy items into destination group's folder]。
12. 從「Project Navigator」中選取您的專案，然後為您的應用程式選擇目標。
13. 開啟應用程式目標的「建構階段」分頁，然後在「連結程式庫與二進位檔」中新增下列架構：
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

14. 選擇您的專案 (而不是特定目標)，然後開啟 [Build Settings] 分頁標籤。在「Other Linker Flags」部分中，新增 -ObjC。如果您沒有看到這些設定，請將「Build Settings」列中的篩選器從「Basic」變更為「All」。

使用 Swift 套件管理員

1. 如果您還沒有 Xcode 專案，請立即建立專案並儲存至本機電腦。(如果你剛開始使用 iOS 開發應用程式，請建立新專案並選取 iOS 應用程式範本)。在 Xcode 11.7 以下版本中，建立單一檢視畫面應用程式)。
2. 新增 Maps SDK for iOS 做為依附元件。請參閱「安裝 SDK」瞭解相關選項。
3. 在 Xcode 專案中前往 File -> Swift Packages -> Add Package Dependency。
4. 在顯示的視窗中，輸入 Maps SDK for iOS 公用程式庫存放區網址 https://github.com/googlemaps/google-maps-ios-utils，然後選取「下一步」。
• 此時，系統可能會提示您透過 GitHub 帳戶進行驗證。按照操作說明建立 GitHub 個人存取權杖，以便繼續執行程序。
5. 在下一個視窗中，選取「版本」圓形按鈕選項，然後從下拉式選單中選取「精確」，然後輸入最新版的 Maps SDK for iOS 公用程式庫 (例如「3.4.0&」)，然後選取「下一步」。

在應用程式中加入 API 金鑰

請參閱設定 Xcode 專案，瞭解如何產生 API 金鑰並將其新增到 Xcode 專案中。

建立並執行專案

新增 API 金鑰後，請建構並執行專案。

為應用程式新增公用程式

如要進一步瞭解如何在應用程式中使用這個公用程式，請參閱相關公用程式的說明文件：

• 標記叢集
• Quadtree
• KML 轉譯
• GeoJSON 轉譯
• 熱視圖