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 範例應用程式。請按照下列步驟安裝並試用 Places SDK for iOS 範例應用程式。

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

  2. 開啟終端機視窗，前往展開範例檔案的目錄，然後深入瞭解要使用的版本目錄：

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/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. 請按照下方的適當操作說明，將 API 金鑰新增至應用程式。

    SwiftUI

    在與範例應用程式的 Info.plist 檔案 (GooglePlacesDemos/GooglePlacesDemos) 相同的目錄中，為 API 金鑰建立名為 GooglePlacesDemos.xcconfig 的本機設定檔。

    在設定檔中新增一行，定義 API 金鑰：

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    將 YOUR_PLACES_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」。

  7. 建構應用程式。
  8. 如果首次執行應用程式時，建構作業失敗或應用程式因 API 金鑰發生錯誤而當機，請確認您已按照上述操作說明提供必要金鑰。
  9. 執行範例應用程式時，iOS 模擬器視窗會顯示地點示範清單。
  10. 如果系統提示允許存取位置資訊，請選擇「允許」。
  11. 您選擇的範例現在可以執行。