Google Maps-Hilfsprogramm für den KML-Import

1. Einführung
2. KML-Ebenen hinzufügen
3. KML-Ebenen entfernen
4. KML-Container aufrufen
5. KML-Ortsmarkierungen und KML-Boden-Overlays aufrufen
6. KML-Attribute aufrufen
7. Durch KML unterstützte Funktionen

Einführung

KML ist eine Erweiterung des XML-Datenformats und stellt geografische Daten auf einer Karte dar. Mit diesem Dienstprogramm können Sie KML-Objekte in geografische Formen umwandeln und als Ebene rendern, die über die Karte gelegt wird. Rufe addLayerToMap() bzw. removeLayerFromMap() auf, um deine KML-Daten der Karte hinzuzufügen oder daraus zu entfernen. Um auf Attribute in einem KML-Objekt zuzugreifen, rufen Sie getProperties() für eine Ortsmarkierung, ein Boden-Overlay, ein Dokument oder einen Ordner auf.

KML-Ebenen der Karte hinzufügen

Erstelle zuerst eine Instanz der Klasse KmlLayer, um der Karte eine Datenebene hinzuzufügen. Es gibt zwei Möglichkeiten, eine KmlLayer zu instanziieren.

Wenn Sie einen KML-Datensatz aus einer lokalen Ressource importieren und rendern möchten, ist Folgendes erforderlich:

• Ein GoogleMap-Objekt, in dem die Ebene gerendert werden soll
• Eine lokale Ressourcendatei mit den KML-Daten
• Ein Context-Objekt, das zum Öffnen von lokalen Ressourcen erforderlich ist

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

      

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

      

Um ein KML-Dataset aus einem lokalen Stream zu importieren und zu rendern, ist Folgendes erforderlich:

• Ein GoogleMap-Objekt, in dem die Ebene gerendert werden soll
• Ein InputStream mit den KML-Daten
• Ein Context-Objekt, das zum Öffnen von lokalen Ressourcen erforderlich ist

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

      

Nachdem Sie eine KmlLayer erstellt haben, rufen Sie addLayerToMap()() auf, um die importierten Daten in die Karte aufzunehmen.

layer.addLayerToMap()

      

layer.addLayerToMap();

      

KML-Ebenen entfernen

Angenommen, Sie haben diese KmlLayer erstellt:

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

      

Um die Ebene aus der Karte zu entfernen, rufen Sie removeLayerFromMap() auf:

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

KML-Container aufrufen

Um auf alle Container zuzugreifen, die der Ebene hinzugefügt wurden, können Sie getContainers() für die erstellte Ebene aufrufen. Mit hasContainers() können Sie prüfen, ob ein Container verschachtelte Container enthält. Um diese geschachtelten Container aufzurufen, rufst du, ähnlich wie beim Bearbeiten der Ebenen, getContainers() auf.

Auf Container zugreifen, die nicht in einem KmlLayer- oder KmlContainer:-Objekt verschachtelt sind:

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

      

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

      

So greifen Sie auf Container zu, die in einem KmlLayer- oder KmlContainer-Objekt verschachtelt sind:

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-Ortsmarkierungen und KML-Boden-Overlays aufrufen

Um auf Ortsmarkierungen oder Boden-Overlays zuzugreifen, die der Ebene hinzugefügt wurden, können Sie getPlacemarks() oder getGroundOverlays() für eine Ebene oder einen Container aufrufen. Beim Aufrufen von beiden wird ein iterierbarer Wert von KmlPlacemarks bzw. KmlGroundOverlays zurückgegeben.

So greifen Sie beispielsweise über eine Ebene auf KmlPlacemark-Objekte zu:

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

      

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

      

KML-Attribute aufrufen

Um auf ein Attribut in einem Container oder eine Ortsmarkierung zuzugreifen, müssen Sie getProperty() aufrufen und einen Attributschlüssel übergeben. Sie können auch hasProperty() aufrufen, um zu prüfen, ob das Attribut vorhanden ist. Im nachfolgenden Beispiel wird gezeigt, wie Sie den Eigenschaftswert „name“ aus einem Container abrufen, sofern vorhanden.

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

      

Klickereignisse für KML-Geometrie

Mit KmlLayer.OnFeatureClickListener() lassen sich Klickereignisse für die Geometrieelemente der Karte erfassen. Im folgenden Beispiel wird die ID eines Elements protokolliert, wenn der Nutzer darauf klickt:

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

      

Demo-App ansehen

Ein Beispiel zum Importieren einer KML-Datei und Erstellen einer Ebene mithilfe dieser Datei ist in der KmlDemoActivity der Demo-App verfügbar, die mit der Dienstprogrammbibliothek ausgeliefert wird. Im Einrichtungsleitfaden erhältst du Informationen zum Ausführen der Demo-App.

Durch KML unterstützte Funktionen