Maps SDK for iOS 程式碼範例

GitHub 上的 Maps SDK for iOS 存放區包含範例，說明如何在 iOS 應用程式中使用 Maps SDK for iOS。範例應用程式包含 SDK 精選功能的程式碼，可做為應用程式的起點。

Maps SDK for iOS 範例清單

下列為示範應用程式中包含的主要活動範例，連結的網頁上會示範相關活動，可供您快速參考。如需可用範例的完整清單，請參閱 GitHub 範例資料夾。

• 顯示基本地圖
• 顯示標記的資訊視窗
• 在地圖上新增標記
• 反向地理編碼位置
• 啟用及停用地圖手勢操作
• 處理標記事件
• 啟用「我的位置」按鈕
• 在地圖上繪製多邊形
• 在地圖上繪製折線

在本機執行完整的範例應用程式

您可以從 GitHub 下載封存檔，取得 Maps SDK for iOS 範例應用程式。請按照下列步驟安裝及試用 Maps SDK for iOS 範例應用程式。

1. 執行 git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git 將範例存放區複製到本機目錄。

2. 開啟終端機視窗，前往複製範例檔案的目錄，然後深入 GoogleMaps 目錄：

   Swift

   cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
   pod install
   open GoogleMapsSwiftDemos.xcworkspace

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   pod install
   open GoogleMapsDemos.xcworkspace

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

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

6. 在 SDKConstants.swift 檔案 (Swift) 或 SDKDemoAPIKey.h 檔案 (Objective-C) 中，移除下列行，因為這會用來註冊使用者定義的問題：

   Swift

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

   Objective-C

   #error Register for API Key and insert here.

7. 建構並執行專案。iOS 模擬器視窗隨即顯示 Maps SDK 示範清單。
8. 選擇其中一個顯示的選項，即可試用 Maps SDK for iOS 的功能。
9. 如果系統提示您允許 GoogleMapsDemos 存取您的位置，請選擇「允許」。