設定和示範

選取平台: Android iOS

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

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

視需要安裝 CocoaPods

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

如果您還沒有 CocoaPods 工具,請從終端機執行下列指令,以在 macOS 上安裝這個工具:

sudo gem install cocoapods

詳情請參閱 CocoaPods 入門指南

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

公用程式庫內含試用版應用程式,您可以安裝,然後再試用各項公用程式。

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

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

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

將公用程式庫安裝為 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.2.2'
    end
  4. 執行 pod install
  5. 關閉 Xcode,然後開啟 (按兩下) 專案的 .xcworkspace 檔案來啟動 Xcode。從現在起,您必須使用 .xcworkspace 檔案來開啟專案。

注意:標記叢集公用程式取決於四重樹,但您可以在不建立標記叢集的情況下使用四樹狀圖。如果只想使用四葉樹公用程式,可以將 pod 檔案中的 pod 'Google-Maps-iOS-Utils' 變更為 'Google-Maps-iOS-Utils/QuadTree'

使用 Carthage

  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,以及這些 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
  10. 以滑鼠右鍵按一下專案中的 GoogleMaps.framework,然後選取 [Show in Finder]
  11. Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundleResources 資料夾拖曳至專案。畫面顯示提示時,請確保您並選取 [Copy items into destination group's folder]
  12. 從「Project Navigator」中選取您的專案,然後為您的應用程式選擇目標。
  13. 開啟應用程式目標的「Build 階段」分頁,然後在「Link Binary with Libraries」中新增下列架構:
    • 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 Package Manager

  1. 如果你還沒有 Xcode 專案,請立即建立專案,並儲存至本機電腦。(如果您是 iOS 開發新手,請建立新專案並選取「iOS App Template」。在 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. 在下一個視窗中,選取「版本」圓形按鈕選項,從下拉式選單中選取「完全比對」,輸入最新版本的 Maps SDK for iOS 公用程式庫 (例如「3.4.0」),然後選取「下一步」

在應用程式中加入 API 金鑰

想瞭解如何產生 API 金鑰並新增到 Xcode 專案,請參閱「設定 Xcode 專案」一文。

建構並執行專案

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

在應用程式中新增公用程式

如要進一步瞭解如何在應用程式中使用各項公用程式,請參閱各公用程式的說明文件: