設定和示範

選取平台： Android iOS

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

如要試用這些公用程式，您可以採取下列任一做法：

將 Maps SDK for iOS 公用程式庫加進 Xcode 專案

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

使用 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'。

在應用程式中加入 API 金鑰

如要瞭解如何產生 Xcode 專案，請參閱「設定 Xcode 專案」一文 並新增 API 金鑰至您的 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 檔案開啟專案。

使用 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。

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