Utilità di importazione KML di Google Maps

1. Introduzione
2. Aggiungere un livello KML
3. Cancellare un livello KML
4. Accedere ai contenitori KML
5. Accedere a segnaposto KML e overlay al suolo KML
6. Accedere alle proprietà KML
7. Funzionalità supportate da KML

Introduzione

KML è un'estensione del XML formato dei dati e rappresenta i dati geografici su una mappa. Utilizzando questa utilità, puoi convertire oggetti KML in forme geografiche e visualizzarli come livello in cima a una mappa. Per aggiungere e rimuovere i dati KML da e verso la mappa, richiama addLayerToMap() e removeLayerFromMap() rispettivamente. Per accedere alle proprietà in un oggetto KML, richiama getProperties() su qualsiasi segnaposto, overlay al suolo, documento o Cartella.

Aggiungere un livello KML alla mappa

Per aggiungere un livello dati alla mappa, devi prima creare un'istanza del metodo KmlLayer corso. Esistono due modi per creare un'istanza KmlLayer.

Per importare ed eseguire il rendering di un set di dati KML da una risorsa locale, hai bisogno di:

• Un oggetto GoogleMap in cui deve essere eseguito il rendering del livello.
• Un file di risorsa locale contenente i dati KML.
• Un oggetto Context, necessario per aprire una risorsa locale .

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

      

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

      

Per importare ed eseguire il rendering di un set di dati KML da uno stream locale, hai bisogno di:

• Un oggetto GoogleMap in cui deve essere eseguito il rendering del livello.
• Un elemento InputStream contenente i dati KML.
• Un oggetto Context, necessario per aprire risorse locali.

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

      

Dopo aver creato un KmlLayer, chiama addLayerToMap()() per aggiungere i dati importati alla mappa.

layer.addLayerToMap()

      

layer.addLayerToMap();

      

Cancellare un livello KML

Supponiamo che tu abbia creato questo 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);

      

Per rimuovere il livello dalla mappa, chiama removeLayerFromMap():

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

Accedere ai contenitori KML

Per accedere ai container che sono stati aggiunti al livello, puoi chiamare getContainers() sul livello che hai creato. Per verificare se un container ha container nidificati, puoi chiamare hasContainers(). Per accedere a questi container nidificati, in modo simile cosa puoi fare nel tuo livello, puoi richiamare getContainers()

Per accedere ai contenitori che non sono nidificati in un KmlLayer o KmlContainer:

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

      

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

      

Per accedere ai contenitori che sono nidificati in un KmlLayer oppure 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());
        }
    }
}

      

Accesso a segnaposto KML e overlay al suolo KML

Per accedere a qualsiasi segnaposto o overlay al suolo aggiunto al livello, puoi chiamare getPlacemarks() o getGroundOverlays() su un livello o un container. Chiamando una delle due opzioni restituisce un valore iterabile di KmlPlacemarks rispettivamente KmlGroundOverlays.

Ad esempio, per accedere a un oggetto KmlPlacemark da un livello:

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

      

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

      

Accedere alle proprietà KML

Per accedere a qualsiasi proprietà in un contenitore o un segnaposto, richiama getProperty() e assegnargli una chiave di proprietà. Puoi anche chiamare hasProperty() per verificare se esiste. Questo esempio mostra come recupera il valore della proprietà "name" da un container, se esistente.

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

      

Eventi di clic sulla geometria KML

Puoi utilizzare KmlLayer.OnFeatureClickListener() per rimanere in ascolto degli eventi di clic nella elementi geometrici sulla mappa. L'esempio seguente registra l'ID di una caratteristica quando l'utente fa clic sulla funzionalità:

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

      

Guarda l'app demo

Esempio di importazione di un file KML e creazione di un livello dai un'occhiata a KmlDemoActivity nell'app demo fornito insieme alla libreria di utility. La guida alla configurazione ti mostra come per eseguire l'app demo.

Funzionalità supportate da KML