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 範例應用程式。
- 執行
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git
將範例存放區複製到本機目錄。 開啟終端機視窗,前往複製範例檔案的目錄,然後深入 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
- 在 Xcode 中,按下編譯按鈕,即可使用目前的配置建構應用程式。建構作業會產生錯誤,提示您在
SDKConstants.swift
檔案 (Swift) 或SDKDemoAPIKey.h
檔案 (Objective-C) 中輸入 API 金鑰。 - 如果您尚未取得 API 金鑰,請按照操作說明在 Google Cloud 控制台中設定專案並取得 API 金鑰。在 Cloud 控制台中設定金鑰時,您可以限制金鑰,只允許範例應用程式的軟體包 ID 使用金鑰,確保只有您的應用程式可以使用金鑰。SDK 範例應用程式的預設套件 ID 為
com.example.GoogleMapsDemos
。 - 編輯 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";
- 在
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.
- 建構並執行專案。iOS 模擬器視窗隨即顯示 Maps SDK 示範清單。
- 選擇其中一個顯示的選項,即可試用 Maps SDK for iOS 的功能。
- 如果系統提示您允許 GoogleMapsDemos 存取您的位置,請選擇「允許」。