แผนที่ Android KTX

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

การติดตั้ง

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

dependencies {

    // Maps SDK for Android Utils library (includes KTX extensions)
    implementation(libs.android.maps.utils)
}

ตัวอย่างการใช้งาน

ไลบรารี KTX ช่วยให้คุณใช้ประโยชน์จากฟีเจอร์ต่างๆ ของภาษา Kotlin ได้ เช่น ฟังก์ชันส่วนขยาย, พารามิเตอร์ที่มีชื่อและอาร์กิวเมนต์เริ่มต้น, การประกาศการแยกโครงสร้าง และโครูทีน

การดึงข้อมูล GoogleMap โดยใช้ Coroutine

การเข้าถึง GoogleMap สามารถดึงข้อมูลได้โดยใช้โครูทีน

scope.launch {
    if (context is FragmentActivity) {
        val mapFragment =
            context.supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        val googleMap = mapFragment?.awaitMap()
    }
}

การเพิ่มเครื่องหมาย

คุณเพิ่มเครื่องหมายได้โดยใช้วิธีการสไตล์ DSL addMarker()

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
    position(sydney)
    title("Marker in Sydney")
}

กำลังรวบรวมเหตุการณ์จากกล้อง

ระบบจะรวบรวมเหตุการณ์ต่างๆ เช่น การเคลื่อนไหวของกล้อง ผ่าน Kotlin Flow

scope.launch {
    googleMap.cameraMoveEvents().collect {
        Log.d("KTX", "Received camera move event")
    }
}

ดูรายการฟีเจอร์ทั้งหมดที่รองรับได้โดยอ่านเอกสารอ้างอิง

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

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

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

1. จาก GitHub ให้โคลนหรือดาวน์โหลดไฟล์ ZIP
2. ใน Android Studio ให้เลือกไฟล์ -> เปิด แล้วไปที่ไดเรกทอรีและเปิดโฟลเดอร์ที่คุณเพิ่งโคลนหรือดาวน์โหลด
3. เพิ่มคีย์ API ลงในแอปเดโม
1. รับคีย์ Maps SDK สำหรับ Android
2. สร้างไฟล์ชื่อ secrets.properties ในไดเรกทอรีราก ไฟล์นี้ไม่ควรอยู่ภายใต้การควบคุมเวอร์ชันเพื่อปกป้องคีย์ API ของคุณ
3. เพิ่มบรรทัดเดียวนี้ใน secrets.properties
   

   MAPS_API_KEY="YOUR_API_KEY"

   โดย YOUR_API_KEY คือคีย์ API จริงที่คุณได้รับในขั้นตอนแรก คุณดูตัวอย่างได้ที่ secrets.defaults.properties
4. ในการกำหนดค่าการเรียกใช้ ให้เลือกโมดูล app-ktx
5. เลือกเรียกใช้ "app-ktx"

ขั้นตอนถัดไป

คุณอาจสนใจไลบรารีส่วนขยาย Kotlin อื่นๆ สำหรับ Google Maps Platform ด้วย ดังนี้

• KTX สำหรับไลบรารีของยูทิลิตี Maps SDK สำหรับ Android
• KTX สำหรับ Places SDK for Android