ส่วนขยาย Kotlin ของ Maps Android (KTX) คือชุดส่วนขยาย 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 { // KTX for the Maps SDK for Android library implementation("com.google.maps.android:maps-ktx:5.2.0") }
ตัวอย่างการใช้งาน
ไลบรารี 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 ให้เลือกไฟล์ -> เปิด แล้วไปที่ไดเรกทอรีและเปิดโฟลเดอร์ที่คุณเพิ่งโคลนหรือดาวน์โหลด
- เพิ่มคีย์ 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 ด้วย