ส่วนขยาย Kotlin (KTX) ของ Maps Android คือชุดส่วนขยาย Kotlin สำหรับ Maps SDK สำหรับ Android และไลบรารียูทิลิตี Maps SDK สำหรับ Android ส่วนขยายเหล่านี้มีฟีเจอร์ภาษา Kotlin ที่ช่วยให้คุณเขียน Kotlin ที่กระชับและเป็นสำนวน เมื่อพัฒนาสำหรับ Maps SDK สำหรับ Android KTX ของ Maps เป็นโอเพนซอร์สและพร้อมให้บริการใน GitHub พร้อมตัวอย่าง
การติดตั้ง
หากต้องการติดตั้ง KTX สำหรับ Maps SDK สำหรับ Android และสำหรับไลบรารียูทิลิตี Maps SDK สำหรับ
Android (ไม่บังคับ) ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle.kts
dependencies { // KTX for the Maps SDK for Android library implementation(libs.maps.ktx) }
ตัวอย่างการใช้งาน
ไลบรารี KTX ช่วยให้คุณใช้ประโยชน์จากฟีเจอร์ต่างๆ ของภาษา Kotlin เช่น ฟังก์ชันส่วนขยาย พารามิเตอร์ที่มีชื่อและอาร์กิวเมนต์เริ่มต้น การประกาศการแยกโครงสร้าง และโครูทีน
การดึงข้อมูล GoogleMap โดยใช้โครูทีน
คุณเรียกข้อมูลการเข้าถึง GoogleMap ได้
โดยใช้โครูทีน
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { val mapFragment: SupportMapFragment? = supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment val googleMap: GoogleMap? = mapFragment?.awaitMap() } }
การเพิ่มเครื่องหมาย
คุณเพิ่มเครื่องหมายได้โดยใช้วิธีการรูปแบบ DSL addMarker()
val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
position(sydney)
title("Marker in Sydney")
}การรวบรวมเหตุการณ์จากกล้อง
ระบบจะรวบรวมเหตุการณ์ต่างๆ เช่น การเคลื่อนไหวของกล้อง ผ่าน Kotlin Flow
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { googleMap.cameraMoveEvents().collect { print("Received camera move event") } } }
ดูรายการฟีเจอร์ที่รองรับทั้งหมดได้โดยอ่านเอกสารอ้างอิง
ลองใช้แอปพลิเคชันตัวอย่าง
ที่เก็บ GitHub สำหรับไลบรารีนี้ยังมีแอปพลิเคชันเดโม ที่แสดงวิธีใช้ไลบรารี Maps KTX ในแอปของคุณเองด้วย
หากต้องการลองใช้แอปพลิเคชันเดโม ให้ทำตามขั้นตอนต่อไปนี้
- จาก GitHub ให้โคลนหรือดาวน์โหลดไฟล์ ZIP
- ใน Android Studio ให้เลือก File -> Open แล้วไปที่ไดเรกทอรีและเปิดโฟลเดอร์ที่คุณเพิ่งโคลนหรือดาวน์โหลด
- เพิ่มคีย์ API ลงในแอปเดโม
- รับคีย์ Maps SDK สำหรับ Android
- สร้างไฟล์ชื่อ
secrets.propertiesในไดเรกทอรีราก ไม่ควรเก็บไฟล์นี้ไว้ภายใต้การควบคุมเวอร์ชันเพื่อปกป้องคีย์ API - เพิ่มบรรทัดเดียวนี้ลงใน
secrets.properties
MAPS_API_KEY="YOUR_API_KEY"
YOUR_API_KEYคือคีย์ API จริงที่คุณได้รับในขั้นตอนแรก คุณดูsecrets.defaults.propertiesเป็นตัวอย่างได้ - เลือกโมดูล app-ktx ในส่วนการกำหนดค่าการเรียกใช้
- เลือกเรียกใช้ "app-ktx"
ขั้นตอนถัดไป
คุณอาจสนใจไลบรารีส่วนขยาย Kotlin อื่นๆ สำหรับ Google Maps Platform ด้วย