地點 Android KTX 總覽與設定

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

安裝 Places SDK 適用的 KTX

若想為 Places SDK for Android 安裝 KTX,請在應用程式層級的 build.gradle 檔案中新增以下依附元件。

dependencies {
    implementation 'com.google.maps.android:places-ktx:0.4.0'
}

如果您搭配 Maps SDK 3 Beta 版使用 Places 靜態程式庫,請改為在應用程式層級的 build.gradle 檔案中新增以下依附元件。

dependencies {
    implementation 'com.google.maps.android:places-v3-ktx:0.4.0'
}

試用範例應用程式

這個程式庫的 GitHub 存放區也提供了試用版應用程式,示範如何在您的應用程式中使用 Places KTX 程式庫。

Places KTX 範例應用程式的第一個畫面,顯示所選項目
Places Search Demo 應用程式畫面

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

  1. GitHub 中複製或下載 ZIP 檔案。
  2. 在 Android Studio 中選擇「File」(檔案) ->「Open」(開啟),然後前往該目錄,然後開啟您剛才複製或下載的資料夾。
  3. 在試用版應用程式中新增 API 金鑰。
    1. 取得 Places API 金鑰
    2. 在根目錄中建立名為 secure.properties 的檔案。這個檔案「不得」在版本管控下保護 API 金鑰。
    3. 將這一行程式碼新增至 secure.properties
      PLACES_API_KEY=”YOUR_API_KEY”
      其中 YOUR_API_KEY 是您在第一個步驟中取得的實際 API 金鑰。您可以參考 secure.properties.template 範例。
  4. 在執行設定下,選取模組應用程式
  5. 選取「執行應用程式」