Places SDK for iOS 程式碼範例

選取平台: Android iOS JavaScript

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

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

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

Places SDK for iOS 範例應用程式可從 GitHub 下載封存檔。請按照下列步驟安裝並試用 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 Maps 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_KEYMAPS_API_KEY = YOUR_MAPS_API_KEY

    YOUR_PLACES_API_KEYYOUR_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」

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