Places SDK for iOS 程式碼範例

選取平台： Android iOS JavaScript

GitHub 上的 Places SDK for iOS 示範應用程式隨附於 Places SDK for iOS，可展示多項功能，包括 Place Autocomplete 和 Place Photos。此外，這份開發人員指南的每一頁也會提供程式碼片段。您可以匯入和建構應用程式、新增 API 金鑰、查看示範教學，以及使用隨附的程式碼範例著手建構應用程式。

執行範例應用程式時，畫面上會列出您的裝置可執行哪些範例功能。請選取其中一個選項，

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

您可以從 GitHub 下載 Places SDK for iOS 範例應用程式的封存檔，然後按照下列步驟安裝及試用。

  1. 從 GitHub 下載程式碼範例封存檔，然後解壓縮封存檔。或者，將存放區複製到本機目錄： 
    git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git

  2. 開啟終端機視窗，前往展開範例檔案的目錄，然後向下鑽研至 GooglePlaces 目錄：

    Swift

    cd maps-sdk-for-ios-samples/GooglePlaces-Swift/
open GooglePlacesSwiftXCFrameworkDemos.xcodeproj

    Objective-C

    cd maps-sdk-for-ios-samples/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. 在 Xcode 專案中，依序前往「File」 >「Add Package Dependencies」。輸入 https://github.com/googlemaps/ios-places-sdk 做為網址，按 Enter 鍵拉入套件，然後按一下「Add Package」(新增套件)。
  4. 為 Google Cloud 控制台專案啟用 Places SDK for iOS。
  5. 從已啟用 Places API 和/或 Places API (新版) 的專案取得 API 金鑰。
  6. 編輯 SDKDemoAPIKey 檔案，然後將 API 金鑰貼到適當的常數中。例如：

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  7. 如果 Xcode 提示您解鎖 SDKDemoAPIKey 檔案以進行編輯，請選擇「Unlock」。
  8. 如果有的話，請移除下列程式碼行，因為這行是用來註冊問題：

    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.
  9. 建構應用程式。
  10. 如果首次執行應用程式時，建構作業失敗或應用程式因 API 金鑰發生錯誤而當機，請確認您已在 SDKDemoAPIKey 檔案中提供必要金鑰。
  11. 如果您執行 GooglePlaces 範例，iOS 模擬器視窗會顯示「地點示範」清單。
  12. 如果系統提示允許 GooglePlacesDemos 存取您的位置資訊，請選擇「允許」。
  13. 您選擇的範例現在可以執行。