程式碼範例總覽

選取平台： 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 v1.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 Console 專案啟用 Places SDK for iOS。
  4. 如果您還沒有 API 金鑰，請按照操作說明在 Cloud Console 中設定專案並取得 API 金鑰。在 Cloud Console 上設定金鑰時，您可以指定應用程式的軟體包 ID，確保只有您的應用程式可以使用該金鑰。SDK 範例應用程式的預設套件識別碼為 com.example.GooglePlacesDemos。
  5. 編輯 SDKDemoAPIKey 檔案，然後將 API 金鑰貼到適當的常數中。例如：

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. 如果 Xcode 提示您解鎖 SDKDemoAPIKey 檔案進行編輯，請選擇 [解除鎖定]。
  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 模擬工具視窗會顯示 Places Demos 清單。
  11. 如果系統提示您允許 GooglePlacesDemos 存取您的位置，請選擇 [Allow]。
  12. 您所選的範例現已可以執行。

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

開發人員指南中的每個頁面都包含程式碼片段，說明 API 的特定功能。如需相關指南，請參閱本指南中的自動完成、取得目前位置、相片和其他頁面的相關指南。