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 e overlay di Earth KML
6. Accedere alle proprietà KML
7. Funzionalità supportate da KML

Introduzione

KML è un'estensione del formato dati XML e rappresenta i dati geografici su una mappa. Utilizzando questa utilità, è possibile convertire gli oggetti KML in forme geografiche e visualizzarli sotto forma di livello sopra una mappa. Per aggiungere e rimuovere i dati KML da e verso la mappa, chiama rispettivamente addLayerToMap() e removeLayerFromMap(). Per accedere alle proprietà in un oggetto KML, chiama getProperties() in qualsiasi segnaposto, overlay al suolo, documento o cartella.

Aggiungere un livello KML alla mappa

Per aggiungere un livello dati alla mappa, crea prima un'istanza della classe KmlLayer. Esistono due modi per creare un'istanza di KmlLayer.

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

• Un oggetto GoogleMap in cui deve essere visualizzato il livello.
• Un file di risorse locale contenente i dati KML.
• Un oggetto Context, necessario per aprire un file di risorse locale.

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

      

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

      

Per importare e visualizzare un set di dati KML da uno stream locale, devi disporre di:

• Un oggetto GoogleMap in cui deve essere visualizzato il livello.
• Una proprietà InputStream contenente i dati KML.
• Un oggetto Context, necessario per aprire le risorse locali.

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)

      

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:

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)

      

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

layer.removeLayerFromMap();

      

layer.removeLayerFromMap()

      

Accedere ai contenitori KML

Per accedere a tutti i contenitori aggiunti al tuo livello, puoi chiamare getContainers() nel livello che hai creato. Per verificare se un contenitore include contenitori nidificati, puoi chiamare hasContainers(). Per accedere a questi container nidificati, in modo simile a ciò che puoi fare nel tuo livello, puoi chiamare getContainers()

Per accedere ai contenitori non nidificati in KmlLayer o KmlContainer:

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

      

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

      

Per accedere ai container raccolti in un elemento KmlLayer o 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)
        }
    }

      

Accedere a segnaposto e overlay di Earth KML

Per accedere a un segnaposto o a un overlay del suolo aggiunto al livello, puoi chiamare il livello getPlacemarks() o getGroundOverlays() su un livello o un contenitore. La chiamata restituisce rispettivamente un iterabile di KmlPlacemarks o KmlGroundOverlays.

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

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

      

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

      

Accedere alle proprietà KML

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

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

      

Eventi clic geometria KML

Puoi utilizzare KmlLayer.OnFeatureClickListener() per ascoltare gli eventi clic sulle funzionalità geometriche della mappa. Il seguente esempio registra l'ID di una funzionalità quando l'utente fa clic sulla funzionalità:

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

      

Visualizza l'app demo

Per un esempio di importazione di un file KML e di una creazione di un livello con esso, dai un'occhiata al KmlDemoActivity nell'app demo fornita con la libreria di utilità. La guida alla configurazione mostra come eseguire l'app demo.

Funzionalità supportate da KML