ส่วนขยาย 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 { // Maps SDK for Android Utils library (includes KTX extensions) implementation(libs.android.maps.utils) }
ตัวอย่างการใช้
ไลบรารี KTX ช่วยให้คุณใช้ประโยชน์จากฟีเจอร์ภาษา Kotlin หลายอย่าง เช่น ฟังก์ชันส่วนขยาย พารามิเตอร์ที่มีชื่อและอาร์กิวเมนต์เริ่มต้น การประกาศการแยกโครงสร้าง และโครูทีน
การดึงข้อมูล GoogleMap โดยใช้โครูทีน
คุณสามารถดึงข้อมูล GoogleMap ได้
โดยใช้โครูทีน
scope.launch {
if (context is FragmentActivity) {
val mapFragment =
context.supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
val googleMap = mapFragment?.awaitMap()
}
}การเพิ่มมาร์กเกอร์
คุณเพิ่มมาร์กเกอร์ได้โดยใช้เมธอด addMarker() ในรูปแบบ DSL
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 ในแอปของคุณเอง
หากต้องการลองใช้แอปพลิเคชันเดโม ให้ทำตามขั้นตอนต่อไปนี้
- จาก 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 ด้วย ดังนี้