程式碼範例總覽

透過集合功能整理內容 你可以依據偏好儲存及分類內容。
選取平台: Android iOS JavaScript

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

試用 CocoaPods 的 SDK 示範

Places SDK for iOS 以 CocoaPods 廣告連播的形式提供。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 存取你的位置資訊,請選擇 [允許]
  12. 您所選的範例現在可以執行了。

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

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