ส่วนขยาย 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 ให้เพิ่มการอ้างอิงต่อไปนี้ลงในไฟล์ 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 ด้วย