KML

KML (Keyhole Markup Language). KML es un lenguaje de marcado basado en XML para representar datos geográficos en tres dimensiones. Fue desarrollado para ser manejado con Google Earth (originalmente Keyhole antes de ser adquirido por Google) y su gramática contiene muchas similitudes con la de GML.

Las capas KML pueden ser estáticas o dinámicas

• estática: fichero servido a través de un servidor de aplicaciones
• dinámica: servicio que genera el KML al vuelo

Hay varias formas de añadir capas KML en el API:

1.- En el constructor del mapa:

const mapajs = M.map({
	  container:"map",
          controls: ['backgroundlayers'],
          projection: 'EPSG:3857*m',
          layers: ['KML*Delegaciones IGN*https://www.ign.es/web/resources/delegaciones/delegacionesIGN.kml*false']
});

2.- Mediante los métodos addKML/addLayers:

//modo objeto
const kml = new M.layer.KML({
                url: 'https://www.ign.es/web/resources/delegaciones/delegacionesIGN.kml',
                name: "capaKML",
                extract: true
}); 
mapajs.addKML(kml);

//modo cadena
mapajs.addKML('KML*Delegaciones IGN*https://www.ign.es/web/resources/delegaciones/delegacionesIGN.kml*false');

Los parametros indicados corresponden a:

• url: url del fichero o servicio -> https://www.ign.es/web/resources/delegaciones/delegacionesIGN.kml
• layers: permite filtrar el fichero KML por nombre de carpetas (las distintas capas que tiene configurado el archivo)
• name: nombre de la capa que aparecerá en el selector de capa
• maxExtent: Restringe la visibilidad de la capa a una extensión.
• legend: Nombre asociado en el árbol de contenidos, si usamos uno.
• removeFolderChildren: opcional Oculta las carpetas descendientes de las carpetas filtradas, por defecto false.
• infoEventType: Opcional Parametriza el método de activación del popup para obtener la información de una feature ('click' / 'hover'), por defecto 'click'.
• extract: opcional Activa la consulta por click en el feature, por defecto false.

  • Si se desea personalizar un manejador propio para mostrar un popup o label al hacer click en alguno de los features, hay que establecer el atributo extract a true, para que no sólo se active nuestro manejador.

  • Las capas KML cuenta con métedos get y set para modificar el extract.

capa.extract = true; // activa consulta
capa.extract = false; // desactiva consulta
console.log(capa.extract); // muestra el estado de la propiedad

• attribution: Atribución de la capa.

  • name. Nombre de la atribución
  • description. Descripción de la atribución.
  • url. URL de la atribución.
  • contentAttributions. Atribuciones por objetos geográficos, por defecto vacío.
  • contentType. Tipo de url de “contentAttributions” (KML o GeoJSON).

• options: Parámetros que se pasarán a la implementación.

  • label: Etiquetado.
  • scaleLabel: Tamaño del etiquetado.
  • visibility: Define si la capa es visible o no.
  • style: Define el estilo de la capa.
  • predefinedStyles: Estilos predefinidos para la capa, aparecen en el selector de capas "LayerSwitcher" para cambiar el estilo de la capa.
  • minZoom. Zoom mínimo aplicable a la capa.
  • maxZoom. Zoom máximo aplicable a la capa.
  • displayInLayerSwitcher. Indica si la capa se muestra en el selector de capas.
  • opacity. Opacidad de capa, por defecto 1.
  • extractStyles. Extrae estilos del KML.

• vendorOptions: Opciones para la biblioteca base (el código se envía directamente a la librería base para ejecutar la funcionalidad). Ejemplo vendorOptions:

{
 opacity: 0.1,
}

Ejemplo completo de creación de capa KML:

const delegaciones = new M.layer.KML({
  url: 'https://www.ign.es/web/resources/delegaciones/DelegacionesIGN-APICNIG.kml',
  name: "capaKML",
}, {
  visibility: true, // muestra la capa visible,
  maxZoom: 10, // zoom máximo aplicable a la capa
}, {
  opacity: 0.5   // aplica un opacidad a la capa
});

Los métodos de mapa getKML(layer) y removeKML(layer) permiten gestionar las capas KML existentes.

Simbologia

Algunas indicaciones respecto a la simbología de los KML:

• Si la capa es puntual y dispone de simbología que usa imágenes externas, en el mapa se mostrarán las imágenes con su tamaño real. Puede reducirse o ampliarse definiendo un 'scale' en su estilo asociado.
• Cada elemento de la capa KML se etiqueta por defecto con el valor de su atributo 'name'. Se puede modificar el estilo del etiquetado mediante un 'LabelStyle'. Para eliminarlo por completo, basta con especificar un scale 0.

Ejemplo de estilo que reduce a la mitad el tamaño del icono, y elimina el etiquetado.

<Style id="estilo1">
 <IconStyle>
  <scale>0.5</scale>
  <Icon>
    <href>url_imagen.png</href>
  </Icon>
 </IconStyle>
 <LabelStyle>
   <scale>0</scale>
 </LabelStyle>
</Style>

Ejemplo funcional

• Fichero Vectorial KML