程式碼範例總覽

選取平台： 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 1.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.xcodeproj 或 ObjCDemoApp.xcodeproj 的臨時 Xcode 專案中開啟示範內容。

  2. 在 Xcode 中，按下編譯按鈕即可建構，然後執行目前的配置。建構作業會產生錯誤，提示您在 Swift 的 SDKConstants.swift 檔案中輸入 API 金鑰，或在 Objective-C 的 SDKDemoAPIKey.h 檔案中輸入 API 金鑰。
  3. 如果您還沒有 API 金鑰，請按照instructions在 Google Cloud 控制台中設定專案，並取得 API 金鑰。在 Cloud 控制台中設定金鑰時，您可以指定應用程式的軟體包 ID，確保只有應用程式才能使用該金鑰。SDK 範例應用程式的預設軟體包 ID 為 com.example.GoogleMapsDemos。
  4. 編輯 Swift 或 SDKDemoAPIKey.h 檔案的 SDKConstants.swift 檔案，然後將 API 金鑰貼到 apiKey 或 kAPIKey 常數的定義中。例如：

    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 Demo 清單。
  7. 請選擇畫面上顯示的其中一個選項，以試用 Maps SDK for iOS 的功能。
  8. 如果系統提示您允許 GoogleMapsDemos 存取您的位置，請選擇「允許」。

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

開發人員指南中的每個網頁都會提供程式碼片段，說明 API 的特定功能。比如說，您可以參閱該指南的地圖物件、標記和形狀等頁面，瞭解相關的程式碼片段。