ส่วนขยาย Maps Android Kotlin (KTX) คือชุดส่วนขยาย Kotlin สำหรับ Maps SDK สำหรับ Android และไลบรารีของยูทิลิตี Maps SDK สำหรับ Android ส่วนขยายเหล่านี้มีฟีเจอร์ภาษา Kotlin ที่ช่วยให้คุณเขียนโค้ด Kotlin ที่กระชับและเป็นสำนวนเมื่อพัฒนาสำหรับ Maps SDK สำหรับ Android Maps KTX เป็นโอเพนซอร์สและ พร้อมใช้งานบน GitHub พร้อมตัวอย่าง
การติดตั้ง
หากต้องการติดตั้ง KTX สำหรับ Maps SDK สำหรับ Android และไลบรารีของยูทิลิตี Maps SDK สำหรับ Android (ไม่บังคับ) ให้เพิ่มการพึ่งพาต่อไปนี้ลงในไฟล์ 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() } }
การเพิ่มมาร์กเกอร์
คุณสามารถเพิ่มมาร์กเกอร์ได้โดยใช้เมธอด addMarker() ในรูปแบบ DSL
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 ในแอปของคุณเอง
หากต้องการลองใช้แอปพลิเคชันเดโม ให้ทำตามขั้นตอนต่อไปนี้
- โคลนหรือดาวน์โหลดไฟล์ ZIP จาก GitHub
- ใน Android Studio ให้เลือกไฟล์ -> เปิด แล้วไปที่ไดเรกทอรีและเปิดโฟลเดอร์ที่คุณเพิ่งโคลนหรือดาวน์โหลด
- เพิ่มคีย์ 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 ด้วย ดังนี้