Maps Android KTX

ส่วนขยาย Android Kotlin สําหรับแผนที่ (KTX) คือคอลเล็กชันของส่วนขยาย 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
    implementation 'com.google.maps.android:maps-ktx:3.2.1'

    // (Optional) KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:3.2.1'
}

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

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

การดึงข้อมูล GoogleMap โดยใช้ Coroutine

คุณเข้าถึง GoogleMap ได้โดยใช้ Coroutine

lifecycleScope.launchWhenCreated {
  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

lifecycleScope.launchWhenCreated {
  googleMap.cameraMoveEvents().collect {
    print("Received camera move event")
  }
}

โปรดดูรายการฟีเจอร์ทั้งหมดที่รองรับโดยอ่านเอกสารอ้างอิง