ยูทิลิตีการนำเข้า KML ของ Google Maps

1. บทนำ
2. เพิ่มเลเยอร์ KML
3. ล้างเลเยอร์ KML
4. เข้าถึงคอนเทนเนอร์ KML
5. เข้าถึงหมุด KML และการวางซ้อน KML จากพื้นดิน
6. เข้าถึงคุณสมบัติ KML
7. ฟีเจอร์ที่รองรับ KML

บทนำ

KML เป็นส่วนขยายของ XML และแสดงข้อมูลทางภูมิศาสตร์บนแผนที่ เมื่อใช้ยูทิลิตีนี้ สามารถแปลงวัตถุ KML เป็นรูปทรงทางภูมิศาสตร์และแสดงผลเป็นเลเยอร์ ที่ด้านบนของแผนที่ ในการเพิ่มและนำข้อมูล KML ออกไปยังและออกจากแผนที่ ให้ addLayerToMap() และ removeLayerFromMap() ตามลำดับ ในการเข้าถึงคุณสมบัติในออบเจ็กต์ KML ให้เรียก getProperties() บนหมุด, GroundOverlay, เอกสาร หรือ โฟลเดอร์

เพิ่มเลเยอร์ KML ลงในแผนที่

หากต้องการเพิ่มชั้นข้อมูลลงในแผนที่ ให้สร้างอินสแตนซ์ของ KmlLayer ชั้นเรียน การสร้างอินสแตนซ์มี 2 วิธี KmlLayer

หากต้องการนำเข้าและแสดงผลชุดข้อมูล KML จากทรัพยากรในเครื่อง คุณต้องมีสิ่งต่อไปนี้

• ออบเจ็กต์ GoogleMap ที่จะแสดงผลเลเยอร์
• ไฟล์ทรัพยากรในเครื่องที่มีข้อมูล KML
• ออบเจ็กต์ Context ซึ่งจำเป็นสำหรับการเปิดทรัพยากรในเครื่อง

val layer = KmlLayer(map, R.raw.geojson_file, context)

      

KmlLayer layer = new KmlLayer(map, R.raw.geojson_file, context);

      

หากต้องการนำเข้าและแสดงผลชุดข้อมูล KML จากสตรีมในเครื่อง คุณต้องมีสิ่งต่อไปนี้

• ออบเจ็กต์ GoogleMap ที่จะแสดงผลเลเยอร์
• InputStream ที่มีข้อมูล KML
• ออบเจ็กต์ Context ซึ่งจำเป็นสำหรับการเปิดทรัพยากรในเครื่อง

val inputStream: InputStream? =  // InputStream containing KML data
val layer = KmlLayer(map, inputStream, context)

      

InputStream inputStream = // InputStream containing KML data
KmlLayer layer = new KmlLayer(map, inputStream, context);

      

หลังจากสร้าง KmlLayer แล้ว ให้โทร addLayerToMap()()เพื่อเพิ่มข้อมูลที่นำเข้าลงในแผนที่

layer.addLayerToMap()

      

layer.addLayerToMap();

      

ล้างเลเยอร์ KML

สมมติว่าคุณได้สร้าง KmlLayer นี้:

val inputStream: InputStream? =  // InputStream containing KML data
val layer = KmlLayer(map, inputStream, context)

      

InputStream inputStream = // InputStream containing KML data
KmlLayer layer = new KmlLayer(map, inputStream, context);

      

หากต้องการนำเลเยอร์ออกจากแผนที่ โทร removeLayerFromMap():

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

เข้าถึงคอนเทนเนอร์ KML

หากต้องการเข้าถึงคอนเทนเนอร์ใดๆ ที่เพิ่มลงในเลเยอร์ คุณสามารถเรียก getContainers() ในเลเยอร์ที่คุณสร้างขึ้น หากต้องการตรวจสอบว่าคอนเทนเนอร์ใดมีคอนเทนเนอร์ที่ซ้อนกันหรือไม่ คุณสามารถเรียกใช้ hasContainers() หากต้องการเข้าถึงคอนเทนเนอร์ที่ฝังเหล่านี้ ซึ่งคล้ายกับ สิ่งที่คุณทำได้ในเลเยอร์คุณสามารถเรียก getContainers()

เพื่อเข้าถึงคอนเทนเนอร์ที่ไม่ได้ฝังอยู่ใน KmlLayer หรือ KmlContainer:

for (containers in layer.containers) {
    // Do something to container
}

      

for (KmlContainer containers : layer.getContainers()) {
    // Do something to container
}

      

เพื่อเข้าถึงคอนเทนเนอร์ที่อยู่ฝังอยู่ใน KmlLayer หรือ KmlContainer:

fun accessContainers(containers: Iterable<KmlContainer>) {
    for (container in containers) {
        if (container.hasContainers()) {
            accessContainers(container.containers)
        }
    }

      

public void accessContainers(Iterable<KmlContainer> containers) {
    for (KmlContainer container : containers) {
        if (container.hasContainers()) {
            accessContainers(container.getContainers());
        }
    }
}

      

เข้าถึงหมุด KML และการวางซ้อนภาพ KML

เมื่อต้องการเข้าถึงหมุดหรือพื้นดินที่ เมื่อเพิ่มลงในเลเยอร์ คุณสามารถเรียกใช้ getPlacemarks() หรือ getGroundOverlays() บนเลเยอร์หรือคอนเทนเนอร์ การโทรไปอย่างใดอย่างหนึ่งจะ แสดงผล KmlPlacemarks ที่ซ้ำกันหรือ KmlGroundOverlays ตามลำดับ

ตัวอย่างเช่น หากต้องการเข้าถึงออบเจ็กต์ KmlPlacemark จากเลเยอร์ ให้ทำดังนี้

for (placemark in layer.placemarks) {
    // Do something to Placemark
}

      

for (KmlPlacemark placemark : layer.getPlacemarks()) {
    // Do something to Placemark
}

      

เข้าถึงคุณสมบัติ KML

ในการเข้าถึงพร็อพเพอร์ตี้ใดๆ ในคอนเทนเนอร์หรือหมุด ให้เรียก getProperty() และให้คีย์พร็อพเพอร์ตี้ หรือจะโทรหา hasProperty() เพื่อตรวจสอบว่ามีอยู่หรือไม่ ตัวอย่างนี้แสดงวิธี ดึงค่าพร็อพเพอร์ตี้ "name" จากคอนเทนเนอร์ หากมี

for (container in layer.containers) {
    if (container.hasProperty("name")) {
        Log.i("KML", container.getProperty("name"))
    }
}

      

for (KmlContainer container : layer.getContainers()) {
    if (container.hasProperty("name")) {
        Log.i("KML", container.getProperty("name"));
    }
}

      

เหตุการณ์การคลิกรูปเรขาคณิต KML

คุณสามารถใช้ KmlLayer.OnFeatureClickListener() เพื่อตรวจจับกิจกรรมการคลิกบน ฟีเจอร์เรขาคณิตบนแผนที่ ตัวอย่างต่อไปนี้จะบันทึกรหัสของฟีเจอร์เมื่อผู้ใช้ คลิกฟีเจอร์:

// Set a listener for geometry clicked events.
layer.setOnFeatureClickListener { feature ->
    Log.i(
        "KML",
        "Feature clicked: " + feature.id
    )
}

      

// Set a listener for geometry clicked events.
layer.setOnFeatureClickListener(new KmlLayer.OnFeatureClickListener() {
    @Override
    public void onFeatureClick(Feature feature) {
        Log.i("KML", "Feature clicked: " + feature.getId());
    }
});

      

ดูแอปเดโม

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

ฟีเจอร์ที่รองรับ KML