程式碼範例總覽

選取平台: Android iOS JavaScript

Maps SDK for iOS 提供的 SDK 試用版應用程式提供了 SDK 的重要功能範例。查看試用版應用程式的程式碼,瞭解各範例的實作方式。

試用 SDK 示範

Maps SDK for iOS SDK 示範應用程式以 GitHub 中的下載封存檔CocoaPods pod 的形式提供。CocoaPods 是 Swift 和 Objective-C Cocoa 專案的開放原始碼依附元件管理員。

請按照下列步驟安裝及試用 Maps SDK for iOS SDK 示範應用程式。

  1. 使用下列任一種方法取得範例檔案:

    直接透過 GitHub 執行

    1. GitHub 下載程式碼範例封存檔,並將封存解壓縮。
    2. 開啟終端機視窗,前往您展開範例檔案所在的目錄,然後細查 Google 地圖目錄:

      Swift

      cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-main/GoogleMaps
    3. 執行下列指令:

      Swift

      pod install
      open GoogleMapsSwiftDemos.xcworkspace

      Objective-C

      pod install
      open GoogleMapsDemos.xcworkspace

    使用 CocoaPods v1.6.1

    1. 如果您還沒有 CocoaPods 工具,請在終端機中執行下列指令,以便在 macOS 上安裝 1.6.1 版。詳情請參閱 CocoaPods 入門指南
      sudo gem install cocoapods -v1.6.1
    2. 使用 Cocoapods 擷取 Google 地圖檔案:
      pod try GoogleMaps

      在系統顯示提示時,選擇 Swift 或 Objective-C。CocoaPods 會更新規格存放區,然後在名為 SwiftDemoApp.xcodeprojObjCDemoApp.xcodeproj 的臨時 Xcode 專案中開啟示範模式。

  2. 在 Xcode 中按下編譯按鈕進行建構,然後執行目前的配置。該版本會產生錯誤,提示您在 Swift 的 SDKConstants.swift 檔案中或為 Objective-C 輸入SDKDemoAPIKey.h API 時輸入 API 金鑰。
  3. 如果您還沒有 API 金鑰,請按照操作說明在 Google Cloud Console 中設定專案並取得 API 金鑰。在 Cloud Console 中設定金鑰時,您可以指定應用程式的軟體包 ID,確保只有您的應用程式可以使用該金鑰。SDK 範例應用程式的預設套件識別碼是 com.example.GoogleMapsDemos
  4. 編輯 Swift 的 SDKConstants.swift 檔案或 Objective-C 的 SDKDemoAPIKey.h 檔案,然後將 API 金鑰貼到 apiKeykAPIKey 常數的定義中。例如:

    Swift

    static let apiKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  5. 移除下列這一行,因為這用於註冊使用者定義的問題:

    Swift

    #error (Register for API Key and insert here. Then delete this line.”)

    Objective-C

    #error Register for API Key and insert here.
  6. 建構並執行專案。系統隨即顯示 iOS 模擬視窗,顯示「Maps SDK 示範」清單。
  7. 選擇其中一個選項,以試用 Maps SDK for iOS 的功能。
  8. 如果系統提示你允許 GoogleMapsDemos 存取你的位置資訊,請選擇 [允許]

使用開發人員指南中的程式碼片段

開發人員指南中的每個頁面都包含程式碼片段,說明 API 的特定功能。如需這份指南,請參閱本指南中的地圖物件標記形狀和其他頁面。