แผนที่ Android KTX

ส่วนขยาย Kotlin สำหรับ Android (KTX) ของ Maps คือคอลเล็กชันส่วนขยาย Kotlin สำหรับ Maps SDK สำหรับ Android และ Maps SDK สำหรับ Android Utility Library ส่วนขยายเหล่านี้มอบฟีเจอร์ภาษา Kotlin ที่ทำให้คุณสามารถเขียน Kotlin ที่กระชับและสำนวนได้ ขณะพัฒนาสำหรับ Maps SDK สำหรับ Android Maps KTX เป็นโอเพนซอร์สและพร้อมใช้งานบน GitHub พร้อมด้วยตัวอย่าง

การติดตั้ง

หากต้องการติดตั้ง KTX สำหรับ Maps SDK สำหรับ Android และ (ไม่บังคับ) สำหรับ Maps SDK สำหรับ Android Utility Library ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ลงในไฟล์ build.gradle

dependencies {

    // KTX for the Maps SDK for Android library
    implementation 'com.google.maps.android:maps-ktx:5.0.0'
}

ตัวอย่างการใช้งาน

ไลบรารี KTX ช่วยให้คุณใช้ประโยชน์จากฟีเจอร์ที่หลากหลายของภาษา Kotlin ได้ เช่น ฟังก์ชันส่วนขยาย พารามิเตอร์ที่มีชื่อ และอาร์กิวเมนต์เริ่มต้น การทำลายการประกาศ และโครูทีน

การเรียก GoogleMap โดยใช้ Coroutine

คุณดึงข้อมูลการเข้าถึง 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 ในแอปของคุณเอง

หากต้องการลองใช้แอปพลิเคชันเดโม ให้ทำตามขั้นตอนต่อไปนี้

  1. โคลนหรือดาวน์โหลดไฟล์ ZIP จาก GitHub
  2. ใน Android Studio ให้เลือกไฟล์ -> เปิด แล้วไปที่ไดเรกทอรีและเปิดโฟลเดอร์ที่เพิ่งโคลนหรือดาวน์โหลด
  3. เพิ่มคีย์ API ลงในแอปเดโม
    1. รับ Maps SDK สำหรับคีย์ Android
    2. ในไดเรกทอรีราก ให้สร้างไฟล์ชื่อ secrets.properties ไฟล์นี้ไม่ควรอยู่ภายใต้การควบคุมเวอร์ชันเพื่อปกป้องคีย์ API ของคุณ
    3. เพิ่มบรรทัดเดียวนี้ลงใน secrets.properties
      MAPS_API_KEY="YOUR_API_KEY"
      โดยที่ YOUR_API_KEY คือคีย์ API จริงที่คุณได้รับในขั้นตอนแรก ลองดู secrets.defaults.properties เป็นตัวอย่างได้
  4. ในส่วนการกำหนดค่าการเรียกใช้ ให้เลือกโมดูล app-ktx
  5. เลือกเรียกใช้ "app-ktx"

ขั้นตอนถัดไป

คุณอาจสนใจไลบรารีส่วนขยาย Kotlin อื่นๆ สำหรับแพลตฟอร์ม Google Maps ด้วย:

  • KTX สำหรับ Map SDK สำหรับ Android Utility Library
  • KTX สำหรับ Places SDK สำหรับ Android