Tiện ích Nhập KML của Google Maps

1. Giới thiệu
2. Thêm lớp KML
3. Xoá lớp KML
4. Truy cập vào vùng chứa KML
5. Truy cập vào dấu vị trí KML và lớp phủ mặt đất KML
6. Truy cập vào các thuộc tính KML
7. Các tính năng được hỗ trợ KML

Giới thiệu

KML là một phần mở rộng của XML và trình bày dữ liệu địa lý trên bản đồ. Khi sử dụng tiện ích này, bạn có thể chuyển đổi các đối tượng KML thành các hình dạng địa lý và kết xuất chúng dưới dạng một lớp trên đầu bản đồ. Để thêm và xóa dữ liệu KML của bạn vào và ra khỏi bản đồ, hãy gọi addLayerToMap() và removeLayerFromMap() . Để truy cập các thuộc tính trong một đối tượng KML, hãy gọi getProperties() trên bất kỳ Dấu vị trí, GroundOverlay, Tài liệu hoặc Thư mục.

Thêm lớp KML vào bản đồ

Để thêm một lớp dữ liệu vào bản đồ, trước tiên hãy tạo một thực thể của Lớp KmlLayer. Có hai cách để tạo thực thể KmlLayer.

Để nhập và kết xuất tập dữ liệu KML từ một tài nguyên cục bộ, bạn cần:

• Đối tượng GoogleMap mà lớp sẽ được kết xuất.
• Tệp tài nguyên cục bộ chứa dữ liệu KML.
• Đối tượng Context cần có để mở tài nguyên cục bộ .

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

      

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

      

Để nhập và kết xuất tập dữ liệu KML từ một luồng cục bộ, bạn cần:

• Đối tượng GoogleMap mà lớp sẽ được kết xuất.
• InputStream chứa dữ liệu KML.
• Đối tượng Context được yêu cầu để mở tài nguyên cục bộ.

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);

      

Sau khi bạn tạo một KmlLayer, hãy gọi addLayerToMap()() để thêm dữ liệu đã nhập vào bản đồ.

layer.addLayerToMap()

      

layer.addLayerToMap();

      

Xóa lớp KML

Giả sử bạn đã tạo KmlLayer này:

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);

      

Để xoá lớp khỏi bản đồ, hãy gọi removeLayerFromMap():

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

Truy cập vào vùng chứa KML

Để truy cập vào bất kỳ vùng chứa nào đã được thêm vào lớp của bạn, bạn có thể gọi getContainers() trên lớp mà bạn đã tạo. Để kiểm tra xem có vùng chứa nào có các vùng chứa lồng nhau không, bạn có thể gọi hasContainers(). Để truy cập vào những vùng chứa lồng nhau này, tương tự như những gì bạn có thể làm trong lớp, bạn có thể gọi getContainers()

Cách truy cập vào các vùng chứa không được lồng trong KmlLayer hoặc KmlContainer:

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

      

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

      

Cách truy cập vào các vùng chứa được lồng trong KmlLayer hoặc 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());
        }
    }
}

      

Truy cập dấu vị trí KML và lớp phủ mặt đất KML

Để truy cập bất kỳ dấu vị trí hoặc lớp phủ mặt đất nào đã đã thêm vào lớp, bạn có thể gọi getPlacemarks() hoặc getGroundOverlays() trên một lớp hoặc vùng chứa. Việc gọi một trong hai thiết bị sẽ trả về một đối tượng có thể lặp lại là KmlPlacemarks hoặc KmlGroundOverlays.

Ví dụ: để truy cập vào các đối tượng KmlPlacemark qua một lớp:

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

      

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

      

Truy cập vào các thuộc tính KML

Để truy cập vào bất kỳ tài sản nào trong vùng chứa hoặc dấu vị trí, hãy gọi getProperty() rồi cấp cho lớp này một khoá thuộc tính. Bạn cũng có thể gọi hasProperty() để kiểm tra xem tệp có tồn tại hay không. Mẫu này trình bày cách truy xuất giá trị thuộc tính "name" từ một vùng chứa, nếu có.

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"));
    }
}

      

Sự kiện nhấp chuột hình học KML

Bạn có thể sử dụng KmlLayer.OnFeatureClickListener() để theo dõi các sự kiện nhấp chuột trên đối tượng hình học trên bản đồ. Ví dụ sau đây ghi lại mã nhận dạng của một tính năng khi người dùng nhấp vào tính năng:

// 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());
    }
});

      

Xem ứng dụng minh hoạ

Để có ví dụ về việc nhập tệp KML và tạo một lớp với nó, hãy xem KmlDemoActivity trong ứng dụng minh hoạ đi kèm với thư viện tiện ích. Hướng dẫn thiết lập cho bạn biết cách để chạy ứng dụng minh hoạ.

Các tính năng được KML hỗ trợ