Places Android KTX 總覽和設定

Places Android KTX 是 Places SDK for Android 的 Kotlin 擴充功能組合。這些擴充功能提供 Kotlin 語言功能,可讓您在開發 Places SDK for Android 時,撰寫出簡潔和慣用的 Kotlin 程式語言。Places KTX 為開放原始碼,您可以在 GitHub 中找到完整程式碼和相關範例。

安裝 Places SDK 適用的 KTX

如要安裝 Maps SDK for Android 適用的 KTX,請在應用程式層級的 build.gradle.kts 檔案中加入以下依附元件。

dependencies {

    // KTX for the Places SDK for Android library
    implementation("com.google.maps.android:places-ktx:3.2.0")
}

使用範例應用程式

這個程式庫的 GitHub 存放區也包含試用版應用程式,可協助您瞭解如何在自有應用程式中使用 Places KTX 程式庫。

Places KTX 範例應用程式的首頁,顯示您的選擇
地點搜尋示範應用程式畫面

如要使用試用版應用程式,請按照下列步驟操作:

  1. GitHub 中,複製或下載 ZIP 檔案。
  2. 在 Android Studio 中,依序選擇「File」>「Open」,然後前往該目錄,開啟剛才複製或下載的資料夾。
  3. 在試用版應用程式中加入 API 金鑰。
    1. 取得 Places API 金鑰
    2. 在根目錄中,建立名為 secrets.properties 的檔案。為保護您的 API 金鑰,這個檔案不得受到版本管控。
    3. secrets.properties 中加入這一行
      PLACES_API_KEY="YOUR_API_KEY"
      其中 YOUR_API_KEY 是您在第一個步驟取得的 API 金鑰。您可以將 local.defaults.properties 視為例子。
  4. 在執行設定下,選取 app-places-ktx 模組。
  5. 選取「Run 'app-places-ktx'」(執行「app-places-ktx」)