Utilidad de importación de KML de Google Maps

1. Introducción
2. Cómo agregar una capa KML
3. Cómo borrar una capa KML
4. Cómo acceder a contenedores KML
5. Cómo acceder a marcadores KML y superposiciones de suelo KML
6. Cómo acceder a propiedades de KML
7. Funciones admitidas por KML

Introducción

KML es una extensión del formato de datos XML y representa datos geográficos en un mapa. Con esta utilidad, puedes convertir objetos KML en formas geográficas y renderizarlas como una capa sobre el mapa. Para agregar tus datos KML al mapa y quitarlos de este, llama a addLayerToMap() y removeLayerFromMap() respectivamente. Para acceder a las propiedades de un objeto KML, llama a getProperties() en cualquier objeto Placemark, GroundOverlay, Document o Folder.

Cómo agregar una capa KML al mapa

Para agregar una capa de datos al mapa, primero crea una instancia de la clase KmlLayer. Existen dos maneras de crear una instancia de KmlLayer.

Para importar y renderizar un conjunto de datos de KML a partir de un recurso local, necesitas lo siguiente:

• Un objeto GoogleMap en el que se renderizará la capa
• Un archivo de recursos local que contenga los datos de KML
• Un objeto Context, que se necesita para abrir un archivo de recursos local

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

      

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

      

Para importar y renderizar un conjunto de datos de KML a partir de un flujo local, necesitas lo siguiente:

• Un objeto GoogleMap en el que se renderizará la capa
• Un objeto InputStream que contenga los datos de KML
• Un objeto Context, que se necesita para abrir recursos locales

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

      

Después de crear un objeto KmlLayer, llama a addLayerToMap()() para agregar los datos importados al mapa.

layer.addLayerToMap()

      

layer.addLayerToMap();

      

Cómo borrar una capa KML

Supongamos que creaste 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);

      

Para quitar la capa del mapa, llama a removeLayerFromMap():

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

Cómo acceder a contenedores KML

Para acceder a cualquier contenedor que se haya agregado a tu capa, puedes llamar a getContainers() en la capa que creaste. Para verificar si un contenedor tiene contenedores anidados, puedes llamar a hasContainers(). Para acceder a estos contenedores anidados, algo similar a lo que puedes hacer en tu capa, puedes llamar a getContainers().

Para acceder a contenedores que no estén anidados en KmlLayer ni KmlContainer:, utiliza este código:

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

      

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

      

Para acceder a contenedores que estén anidados en KmlLayer o KmlContainer, utiliza este código:

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

      

Cómo acceder a marcadores KML y superposiciones de suelo KML

Para acceder a cualquier marcador o superposición de suelo agregados a la capa, puedes llamar a getPlacemarks() o getGroundOverlays() en una capa o contenedor. Si llamas a cualquiera de ellos, se mostrará un elemento iterable de KmlPlacemarks o KmlGroundOverlays, respectivamente.

Por ejemplo, para acceder a objetos KmlPlacemark desde una capa:

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

      

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

      

Cómo acceder a propiedades de KML

Para acceder a cualquier propiedad en un contenedor o un marcador, llama a getProperty() y asígnale una clave de propiedad. También puedes llamar a hasProperty() para comprobar si existe. En el siguiente ejemplo, se muestra cómo recuperar el valor de propiedad "name" de un contenedor, si existe.

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

      

Eventos de clic en geometría de KML

Puedes utilizar KmlLayer.OnFeatureClickListener() para escuchar eventos de clic en las funciones de geometría del mapa. En el siguiente ejemplo, se registra el ID de una función cuando el usuario hace clic en ella:

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

      

Cómo consultar la app de demo

Para ver un ejemplo de cómo importar un archivo KML y crear una capa con él, observa KmlDemoActivity en la app de demostración que se incluye en la biblioteca de utilidades. En la guía de configuración, se muestra cómo ejecutar la app de demostración.

Funciones admitidas por KML