程式碼範例總覽

選取平台: Android iOS JavaScript

Places SDK for iOS 提供的 SDK 試用版應用程式示範了許多功能,包括地點自動完成和地點相片。此外,您也可以在本開發人員指南的每一頁中找到程式碼片段。

試用 CocoaPods 的 SDK 示範內容

Places SDK for iOS 以 CocoaPods Pod 的形式提供。CocoaPods 是 Swift 和 Objective-C Cocoa 專案的開放原始碼依附元件管理員。

Places SDK for iOS 提供一組 SDK 試用版應用程式,您可以使用 pod try 指令安裝及執行:

請按照下列步驟安裝 CocoaPods,並試用 Places SDK for iOS:

  1. 如果您還沒有 CocoaPods 工具,請在終端機上執行下列指令,即可在 macOS 中安裝這項工具。詳情請參閱 CocoaPods 入門指南
    sudo gem install cocoapods
  2. 請使用下列其中一種方法取得範例檔案:

    使用 GitHub 中的檔案

    1. GitHub 下載程式碼範例封存檔,並將封存檔案解壓縮。
    2. 開啟終端機視窗,前往您展開範例檔案的目錄,然後下鑽查看 GooglePlaces 目錄:

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces
    3. 執行下列指令:
      pod install
      open GooglePlacesDemos.xcworkspace

    使用 CocoaPods 1.6.1 版

    1. 開啟終端機視窗並安裝 1.6.1 版:
      sudo gem install cocoapods -v1.6.1
    2. 使用 Cocoapods 擷取 Google 地點檔案:
      pod try GooglePlaces

      CocoaPods 會更新規格存放區,然後在臨時 Xcode 專案 GooglePlacesDemos.xcworkspace 中開啟 SDK 示範。

  3. 為您的 Google Cloud 控制台專案啟用 Places SDK for iOS
  4. 如果您還沒有 API 金鑰,請按照instructions在 Cloud 控制台中設定專案,並取得 API 金鑰。在 Cloud 控制台中設定金鑰時,您可以指定應用程式的軟體包 ID,確保只有應用程式才能使用該金鑰。SDK 範例應用程式的預設軟體包 ID 為 com.example.GooglePlacesDemos
  5. 編輯 SDKDemoAPIKey 檔案,並將 API 金鑰貼到適當的常數中。例如:

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. 如果 Xcode 提示您解鎖 SDKDemoAPIKey 檔案以進行編輯,請選擇「Unlock」
  7. 如果有此行,請移除下列內容,因為該行會用於註冊問題:

    Swift

    #error (在此註冊並插入 API 金鑰。然後刪除這一行)。

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. 再次建構並執行專案。
  9. 如果建構失敗或應用程式在您初次執行時因 API 金鑰錯誤而異常終止,請務必在 SDKDemoAPIKey 檔案中提供必要的金鑰。
  10. 如果您執行 GooglePlaces 示範,iOS 模擬工具視窗會顯示地點介面集清單。
  11. 如果系統提示您允許 GooglePlacesDemos 存取您的位置,請選擇「Allow」(允許)
  12. 您選擇的樣本已可執行。

使用開發人員指南中的程式碼片段

開發人員指南中的每個網頁都會提供程式碼片段,說明 API 的特定功能。例如,請參閱自動完成取得目前地點相片和本指南中的其他頁面等指南。