Narzędzie do importowania plików KML do Map Google

1. Wprowadzenie
2. Dodawanie warstwy KML
3. Usuwanie warstwy KML
4. Dostęp do kontenerów KML
5. Dostęp do oznaczeń miejsc w formacie KML i nakładek na teren KML
6. Dostęp do właściwości KML
7. Funkcje obsługiwane w języku KML

Wprowadzenie

KML jest rozszerzeniem XML format danych i przedstawia dane geograficzne na mapie. Za pomocą tego narzędzia mogą konwertować obiekty KML na kształty geograficzne i renderować je jako warstwy na górze mapy. Aby dodać dane KML do mapy i z niej usunąć, wywołaj addLayerToMap() i removeLayerFromMap() . Aby uzyskać dostęp do właściwości w obiekcie KML, wywołaj funkcję getProperties() w dowolnym oznaczeniu miejsca, nakładki na powierzchnię ziemi, dokumencie lub Folder.

Dodawanie warstwy KML do mapy

Aby dodać do mapy warstwę danych, najpierw utwórz instancję KmlLayer zajęcia. Istnieją 2 sposoby tworzenia instancji KmlLayer

Aby zaimportować i wyrenderować zbiór danych KML z zasobu lokalnego:

• Obiekt GoogleMap, w którym ma być renderowana warstwa.
• Lokalny plik zasobów zawierający dane KML.
• Obiekt Context wymagany do otwierania zasobu lokalnego .

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

      

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

      

Aby zaimportować i wyrenderować zbiór danych KML ze strumienia lokalnego:

• Obiekt GoogleMap, w którym ma być renderowana warstwa.
• Element InputStream zawierający dane KML.
• Obiekt Context wymagany do otwierania zasobów lokalnych.

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

      

Po utworzeniu KmlLayer zadzwoń addLayerToMap()(), aby dodać zaimportowane dane do mapy.

layer.addLayerToMap()

      

layer.addLayerToMap();

      

Usuwanie warstwy KML

Załóżmy, że ten KmlLayer został utworzony przez Ciebie:

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

      

Aby usunąć warstwę z mapy, wywołaj removeLayerFromMap():

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

Dostęp do kontenerów KML

Aby uzyskać dostęp do kontenerów dodanych do warstwy, możesz wywołać funkcję getContainers() w utworzonej warstwie. Aby sprawdzić, czy jakikolwiek kontener ma zagnieżdżone kontenery, możesz wywołać hasContainers() Aby uzyskać dostęp do tych zagnieżdżonych kontenerów, w funkcji co można zrobić w warstwie, nazywa się getContainers()

Aby uzyskać dostęp do kontenerów, które nie są zagnieżdżone w tabeli KmlLayer lub KmlContainer:

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

      

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

      

Aby uzyskać dostęp do kontenerów znajdujących się w obiekcie KmlLayer lub 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());
        }
    }
}

      

Dostęp do oznaczeń miejsc w formacie KML i nakładek na powierzchnię KML

Aby uzyskać dostęp do oznaczenia miejsca lub nakładki na ziemi, które zostały możesz wywołać funkcję getPlacemarks() lub getGroundOverlays() w warstwie lub kontenerze. Połączenie z dowolnym z nich spowoduje zwróci iterację KmlPlacemarks lub KmlGroundOverlays.

Aby na przykład uzyskać dostęp do obiektów KmlPlacemark z poziomu warstwy:

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

      

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

      

Dostęp do właściwości KML

Aby uzyskać dostęp do dowolnej właściwości w kontenerze lub oznaczeniu miejsca, wywołaj getProperty() i podaj mu klucz właściwości. Możesz też zadzwonić hasProperty(), aby sprawdzić, czy istnieje. Z tego przykładu dowiesz się, jak pobiera wartość właściwości „name” z kontenera, o ile istnieje.

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

      

Zdarzenia kliknięcia geometrii KML

Za pomocą KmlLayer.OnFeatureClickListener() możesz nasłuchiwać zdarzeń kliknięcia na stronie obiektów geometrycznych na mapie. Ten przykład rejestruje identyfikator cechy, gdy użytkownik kliknie tę funkcję:

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

      

Zobacz aplikację w wersji demonstracyjnej

Przykład importowania pliku KML i tworzenia warstwy obejrzyj KmlDemoActivity w aplikacji w wersji demonstracyjnej z biblioteką narzędziową. Z przewodnika konfiguracji dowiesz się, aby uruchomić aplikację w wersji demonstracyjnej.

Funkcje obsługiwane w formacie KML