GitHub 上的 Places SDK for iOS 試用版應用程式隨附於 Places SDK for iOS,可展示多項功能,包括 Place Autocomplete 和 Place Photos。此外,這份開發人員指南的每一頁也會提供程式碼片段。您可以匯入和建構應用程式、新增 API 金鑰、查看示範教學,以及使用隨附的程式碼範例做為應用程式的起點。
執行範例應用程式時,畫面上會列出您的裝置可執行哪些範例功能。請選取其中一個選項,
在本機執行完整範例應用程式
Places SDK for iOS 範例應用程式可從 GitHub 下載封存檔。請按照下列步驟安裝並試用 Places SDK for iOS 範例應用程式。
- 從 GitHub 下載程式碼範例封存檔,然後解壓縮封存檔。或者,將存放區複製到本機目錄:
git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git
開啟終端機視窗,前往展開範例檔案的目錄,然後深入要使用的版本目錄:
SwiftUI
cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeprojSwift
cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeprojObjective-C
cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj- 在 Xcode 專案中,依序前往「File」 >「Add Package Dependencies」。輸入 https://github.com/googlemaps/ios-places-sdk 做為網址,按 Enter 鍵拉入套件,然後按一下「Add Package」(新增套件)。
- 為 Google Cloud 控制台專案啟用 Places SDK for iOS 和 Maps SDK for iOS。
- 從已啟用 Places API 和/或 Places API (新版) 的專案取得 API 金鑰。
- 按照下方的適當操作說明,將 API 金鑰新增至應用程式。
SwiftUI
在與範例應用程式的
Info.plist檔案 (GooglePlacesDemos/GooglePlacesDemos) 相同的目錄中,為 API 金鑰建立名為GooglePlacesDemos.xcconfig的本機設定檔。在設定檔中新增兩行,定義 API 金鑰:
PLACES_API_KEY = YOUR_PLACES_API_KEY,MAPS_API_KEY = YOUR_MAPS_API_KEY。將
YOUR_PLACES_API_KEY和YOUR_MAPS_API_KEY替換為上一個步驟中的 API 金鑰。如需建立本機設定檔的說明,請參閱「設定檔 (xcconfig) 格式」。
Swift
編輯
SDKDemoAPIKey檔案,然後將 API 金鑰貼到適當的常數中。例如:let placesAPIKey = "YOUR_API_KEY"
如果存在下列各行,請將其移除:
#error (Register for API Key and insert here. Then delete this line.)
如果 Xcode 提示您解鎖
SDKDemoAPIKey檔案以進行編輯,請選擇「Unlock」。Objective-C
編輯
SDKDemoAPIKey檔案,然後將 API 金鑰貼到適當的常數中。例如:static NSString *const kAPIKey = @"YOUR_API_KEY";
如果存在,請移除下列指令行
#error (Register for API Key and insert here. Then delete this line.)如果 Xcode 提示您解鎖
SDKDemoAPIKey檔案以進行編輯,請選擇「Unlock」。 - 建構應用程式。
- 如果首次執行應用程式時,建構作業失敗或應用程式因 API 金鑰發生錯誤而當機,請確認您已按照上述操作說明提供必要金鑰。
- 執行範例應用程式時,iOS 模擬器視窗會顯示 Places 示範清單。
- 如果系統提示允許試用版應用程式存取位置資訊,請選擇「允許」。
- 您選擇的範例現在可以執行。