GitHub 上的 Places SDK for iOS 示範應用程式,可讓您瞭解多項功能,包括地點自動完成和地點相片。此外,這份開發人員指南的每一頁也會提供程式碼片段。匯入及建構應用程式、新增 API 金鑰、查看示範,以及使用隨附的程式碼範例著手建構應用程式。
執行範例應用程式時,畫面上會列出您的裝置可執行哪些範例功能。請選取其中一個選項,
在本機執行完整的範例應用程式
您可以從 GitHub 下載 Places SDK for iOS 範例應用程式封存檔。請按照下列步驟安裝及試用 Places SDK for iOS 範例應用程式。
- 從 GitHub 下載程式碼範例封存檔,然後解壓縮封存檔。
開啟終端機視窗,前往展開範例檔案的目錄,然後深入 GooglePlaces 目錄:
Swift
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
pod install
open GooglePlacesDemos.xcworkspace
Objective-C
cd maps-sdk-for-ios-samples-master/GooglePlaces
pod install
open GooglePlacesDemos.xcworkspace
- 為 Google Cloud 控制台專案啟用 Places SDK for iOS。
- 如果您還沒有 API 金鑰,請按照操作說明在 Cloud 控制台中設定專案並取得 API 金鑰。在 Cloud 控制台中設定金鑰時,您可以限制金鑰,只允許範例應用程式的軟體包 ID 使用金鑰,確保只有您的應用程式可以使用金鑰。SDK 範例應用程式的預設 bundle ID 為
com.example.GooglePlacesDemos
。 - 編輯
SDKDemoAPIKey
檔案,並將 API 金鑰貼到適當的常數中。例如:Swift
let placesAPIKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- 如果 Xcode 提示您解鎖
SDKDemoAPIKey
檔案以便編輯,請選擇「Unlock」。 - 如果有,請移除下列行,因為這會用來註冊問題:
Swift
#error (Register for API Key and insert here. Then delete this line.)
Objective-C
#error Register your API key and insert here, then delete this line.
- 建構應用程式。
- 如果在您首次執行應用程式時,建構作業失敗或應用程式因 API 金鑰錯誤而當機,請確認您已在
SDKDemoAPIKey
檔案中提供必要的金鑰。 - 如果您執行 GooglePlaces 範例,iOS 模擬器視窗會顯示 Places 示範清單。
- 如果系統提示您允許 GooglePlacesDemos 存取您的位置,請選擇「允許」。
- 您選擇的範例現在可以執行。