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

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

Wstęp

KML to rozszerzenie formatu danych XML, który reprezentuje dane geograficzne na mapie. Za pomocą tego narzędzia możesz przekonwertować obiekty KML na kształty geograficzne i wyrenderować je jako warstwę na mapie. Aby dodać do mapy dane KML lub je z niej usunąć, wywołaj odpowiednio właściwości addLayerToMap() i removeLayerFromMap(). Aby uzyskać dostęp do właściwości w obiekcie KML, wywołaj właściwość getProperties() w dowolnym punkcie oznaczenia miejsca, naziemnym, dokumencie lub folderze.

Dodaj do mapy warstwę KML

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

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

• Obiekt GoogleMap, na którym ma być renderowana warstwa.
• Lokalny plik zasobów zawierający dane KML.
• Obiekt Context, który jest wymagany do otwierania pliku zasobów lokalnych.

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

      

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

      

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

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

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

      

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

      

Po utworzeniu obiektu KmlLayer wywołaj właściwość addLayerToMap()(), aby dodać zaimportowane dane do mapy.

layer.addLayerToMap();

      

layer.addLayerToMap()

      

Wyczyść warstwę KML

Załóżmy, że masz utworzony ten element KmlLayer:

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

      

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

      

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

layer.removeLayerFromMap();

      

layer.removeLayerFromMap()

      

Dostęp do kontenerów KML

Aby uzyskać dostęp do kontenerów, które zostały dodane do warstwy, możesz wywołać metodę getContainers() w utworzonej przez siebie warstwie. Aby sprawdzić, czy któryś z kontenerów ma zagnieżdżone kontenery, możesz wywołać hasContainers(). Aby uzyskać dostęp do tych zagnieżdżonych kontenerów, podobnie jak można to robić w warstwie, możesz wywołać getContainers()

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

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

      

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

      

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

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

      

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

      

Dostęp do oznaczeń miejsc KML i nakładek na poziomie KML

Aby uzyskać dostęp do nakładki oznaczenia lub powierzchni, która została dodana do warstwy, możesz wywołać metodę getPlacemarks() lub getGroundOverlays() w warstwie lub kontenerze. Wywołanie spowoduje zwrócenie iteracji odpowiednio KmlPlacemarks lub KmlGroundOverlays.

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

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

      

for (placemark in layer.placemarks) {
    // 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 oznaczenia miejsca, wywołaj element getProperty() i przyznaj mu klucz właściwości. Możesz też wywołać funkcję hasProperty(), aby sprawdzić, czy istnieje. Ten przykład pokazuje, jak pobrać wartość właściwości "name" z kontenera, jeśli istnieje.

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

      

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

      

Zdarzenia kliknięcia w geometrii KML

Za pomocą właściwości KmlLayer.OnFeatureClickListener() możesz nasłuchiwać zdarzeń kliknięcia w funkcjach geometrycznych na mapie. Poniższy przykład rejestruje identyfikator funkcji, gdy użytkownik ją kliknie:

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

      

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

      

Zobacz aplikację demonstracyjną

Importujemy plik KML i tworzymy w nim warstwę, korzystając z KmlDemoActivity w aplikacji demonstracyjnej, która zawiera bibliotekę narzędzi. Z przewodnika po konfiguracji dowiesz się, jak uruchomić aplikację w wersji demonstracyjnej.

Obsługiwane funkcje formatu KML