設定和示範

選取平台： Android iOS

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

如要試用這些公用程式，您可以：

將 Maps SDK for iOS 公用程式庫新增至 Xcode 專案

如要將公用程式庫新增至 Xcode 工作區，請按照下列步驟操作：

使用 Swift Package Manager

  1. 如果您還沒有 Xcode 專案，請立即建立一個並儲存至本機電腦 (如果您是 iOS 開發新手，請建立新專案，並選取「iOS App 範本」)。在 Xcode 11.7 或更舊版本中，建立 Single View Application。
  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，然後選取「Next」。
    • 此時，系統可能會提示您驗證 GitHub 帳戶。按照操作說明建立 GitHub 個人存取權杖，繼續進行程序。
  5. 在下一個視窗中，選取「Version」單選按鈕，從下拉式清單中選取「Up to Next Major Version」，然後輸入 Maps SDK for iOS 公用程式庫的最新版本號碼 (例如「6.0.0」)。
  6. 按一下「Add to Project」旁的下拉式選單，選取專案，然後選取「Add Package」。

使用 CocoaPods

  1. 如果您還沒有 Xcode 專案，請立即建立一個並儲存至本機電腦 (如果您是 iOS 開發新手，請建立 Single View Application)。
  2. 如果專案中還沒有 Pod 檔案，請在專案目錄中建立名為 Podfile 的檔案。這個檔案定義了專案的依附元件。
  3. 編輯專案的 Pod 檔案，並在 Google-Maps-iOS-Utils Pod 上新增依附元件。以下範例包含 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.1.0' # x-release-please-version
end
  4. 執行 pod install。
  5. 關閉 Xcode，接著按兩下來開啟專案的 .xcworkspace 檔案來啟動 Xcode。從現在起，您必須使用 .xcworkspace 檔案來開啟專案。

注意：標記叢集公用程式取決於四叉樹，但您可以使用四叉樹，而無須標記叢集。如果您只需要四叉樹工具，可以在 Pod 檔案中將 pod 'Google-Maps-iOS-Utils' 變更為 'Google-Maps-iOS-Utils/QuadTree'。

在應用程式中加入 API 金鑰

如要瞭解如何產生 API 金鑰並將其新增至 Xcode 專案，請參閱「設定 Xcode 專案」一文。

建構並執行專案

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

在應用程式中使用公用程式

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

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

公用程式庫隨附試用版應用程式，您可以安裝並試用各公用程式。

安裝試用版應用程式：

使用 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 檔案來開啟專案。

在試用版應用程式中加入 API 金鑰

在「取得 API 金鑰」一文中，您已為應用程式產生 API 金鑰。現在，請將該金鑰新增至試用版應用程式的 Xcode 專案。

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 版本的示範，試用各項公用程式。詳情請參閱下方的「在應用程式中新增公用程式」一節。