ภาพรวมและการตั้งค่า Android KTX ของสถานที่

Places Android KTX คือชุดส่วนขยาย Kotlin สำหรับ Places SDK สำหรับ Android ส่วนขยายเหล่านี้มีฟีเจอร์ภาษา Kotlin ที่ช่วยให้คุณเขียน Kotlin ได้อย่างกระชับและเป็นสำนวนเมื่อ พัฒนาสำหรับ Places SDK สำหรับ Android Places KTX เป็นโอเพนซอร์สและพร้อมให้บริการใน GitHub พร้อมตัวอย่าง

ติดตั้ง KTX สำหรับ Places SDK

หากต้องการติดตั้ง KTX สำหรับ Places SDK สำหรับ Android ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle.kts ระดับแอป

dependencies {

    // Modern Android projects use version catalogs to manage dependencies. To include the Places SDK for Android,
    // first add the following to your gradle/libs.versions.toml file:
    //
    // [versions]
    // places = "5.3.0"
    //
    // [libraries]
    // places = { group = "com.google.android.libraries.places", name = "places", version.ref = "places" }
    //
    // Places SDK for Android (Kotlin extensions and coroutines are built directly into the Places SDK)
    implementation(libs.places)

    // If your project does not use a version catalog, you can use the following dependency instead:
    //
    //    implementation("com.google.android.libraries.places:places:5.3.0")
}

ลองใช้แอปพลิเคชันตัวอย่าง

ที่เก็บข้อมูล GitHub สำหรับไลบรารีนี้ยังมีแอปพลิเคชัน ตัวอย่าง ที่แสดงวิธีใช้ไลบรารี Places KTX ในแอปของคุณเองด้วย

หน้าจอแรกของแอปตัวอย่าง Places KTX ซึ่งแสดงตัวเลือกของคุณ
หน้าจอแอปเดโมการค้นหาสถานที่

หากต้องการลองใช้แอปพลิเคชันตัวอย่าง ให้ทำตามขั้นตอนต่อไปนี้

  1. จาก GitHub ให้โคลนหรือดาวน์โหลดไฟล์ ZIP
  2. ใน Android Studio ให้เลือกไฟล์ -> เปิด แล้วไปที่ ไดเรกทอรีและเปิดโฟลเดอร์ที่คุณเพิ่งโคลนหรือดาวน์โหลด
  3. เพิ่มคีย์ API ลงในแอปเดโม
    1. รับคีย์ API ของ Places
    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. เลือกเรียกใช้ "app-places-ktx"