layer

Descripción

Espacio de nombres de las capas del mapa.

Clases


new <abstract> Layer( [ options ] )


new Raster( [ options ] )


new Vector( [ options ] )

Definiciones de tipos


ClusterOptions

Descripción

Opciones de clustering de puntos de una capa, define si los puntos se tienen que agrupar cuando están más cerca entre sí que un valor umbral.

Hay que tener en cuenta que el archivo config.json de una maquetación puede sobreescribir los valores por defecto de esta propiedad (para ver instrucciones de uso de maquetaciones, consultar Configurar por maquetación).

Propiedades
Nombre Type Atributos Descripción
distance number

Distancia en píxels que tienen que tener como máximo los puntos entre sí para que se agrupen en un cluster.

animate boolean <optional>

Si se establece a true, los puntos se agrupan y desagrupan con una transición animada.

styles SITNA.layer.ClusterStyleOptions <optional>

Opciones de estilo de los clusters.

Ejemplos

<div id="mapa"></div>
<script>
    // Creamos un mapa con una capa de puntos de un KML,
    // clustering activado a 50 pixels y transiciones animadas.
    var map = new SITNA.Map("mapa", {
        workLayers: [
            {
                id: "cluster",
                type: SITNA.Consts.layerType.KML,
                url: "data/PromocionesViviendas.kml",
                title: "Clusters",
                cluster: {
                    distance: 50,
                    animate: true
                }
            }
        ]
    });
</script>

ClusterStyleOptions

Descripción

Opciones de estilo de cluster de puntos. Hay que tener en cuenta que el archivo config.json de una maquetación puede sobreescribir los valores por defecto de esta propiedad (para ver instrucciones de uso de maquetaciones, consultar Configurar por maquetación).

Propiedades
Nombre Type Atributos Descripción
point SITNA.feature.PointStyleOptions <optional>

Opciones de estilo del punto que representa el cluster.

Ejemplos

<div id="mapa"></div>
<script>
    // Creamos un mapa con una capa vectorial,
    // clustering activado a 50 pixels y estilos personalizados.
    var map = new SITNA.Map("mapa", {
        workLayers: [
            {
                id: "cluster",
                type: SITNA.Consts.layerType.VECTOR,
                title: "Clusters",
                styles: {
                    point: {
                        strokeColor: "#0000ff",
                        strokeWidth: 2,
                        fillColor: "#0000ff",
                        fillOpacity: 0.2,
                        radius: 6
                    }
                },
                cluster: {
                    distance: 50,
                    styles: {
                        point: {
                            fillColor: "#f90",
                            fillOpacity: 1,
                            strokeColor: "#c60",
                            strokeWidth: 2,
                            fontColor: "#f90"
                        }
                    }
                }
            }
        ]
    });

    map.loaded(function () {
        // Añadimos puntos aleatorios
        var extent = SITNA.Cfg.initialExtent;
        var dx = extent[2] - extent[0];
        var dy = extent[3] - extent[1];

        var randomPoint = function () {
            var x = extent[0] + Math.random() * dx;
            var y = extent[1] + Math.random() * dy;
            return [x, y];
        }

        for (var i = 0; i < 200; i++) {
            var point = randomPoint();
            map.addMarker(point, {
                layer: "cluster",
                data: {
                    x: point[0],
                    y: point[1]
                }
            });
        }
    });
</script>

HeatmapStyleOptions

Descripción

Opciones de estilo de mapa de calor. Hay que tener en cuenta que el archivo config.json de una maquetación puede sobreescribir los valores por defecto de esta propiedad (para ver instrucciones de uso de maquetaciones, consultar Configurar por maquetación).

Propiedades
Nombre Type Atributos Valor por defecto Descripción
blur number <optional>
15

Ancho en píxeles del difuminado de las manchas del mapa de calor.

gradient Array.<string> <optional>
["#00f", "#0ff", "#0f0", "#ff0", "#f00"]

Gradiente de colores de las manchas de mapa de calor. Debe ser un array de cadenas CSS de color.

radius number <optional>
8

Radio en píxeles de la mancha unitaria en el mapa de calor.

Ejemplos

<div id="mapa"></div>
<script>
    // Crear un mapa con una capa vectorial, mapa de calor activado con un radio de 32 píxeles,
    // un difuminado de 16 píxeles y un gradiente de colores azul-rojo-dorado.
    var map = new SITNA.Map("mapa", {
        workLayers: [
            {
                id: "heatmap",
                type: SITNA.Consts.layerType.VECTOR,
                title: "Mapa de calor",
                heatmap: {
                    radius: 16,
                    blur: 32,
                    gradient: [
                        "#00008b",
                        "#dc143c",
                        "#ffd700"
                    ]
                }
            }
        ]
    });

    map.loaded(function () {
        // Añadimos puntos aleatorios
        var extent = SITNA.Cfg.initialExtent;
        var dx = extent[2] - extent[0];
        var dy = extent[3] - extent[1];

        var randomPoint = function () {
            var x = extent[0] + Math.random() * dx;
            var y = extent[1] + Math.random() * dy;
            return [x, y];
        }

        for (var i = 0; i < 200; i++) {
            var point = randomPoint();
            map.addMarker(point, {
                layer: "heatmap",
                data: {
                    x: point[0],
                    y: point[1]
                }
            });
        }
    });
</script>

LayerOptions

Descripción

Opciones de capa. Este objeto se utiliza al configurar un mapa, el control del catálogo de capas o como parámetro al añadir una capa.

Propiedades
Nombre Type Atributos Descripción
id string

Identificador único de capa. No puede haber en un mapa dos capas con el mismo valor de id.

format string <optional>

En las capas de tipo WMS y WMTS, es el tipo MIME del formato de archivo de imagen a obtener del servicio. En las capas de tipo VECTOR, es el tipo MIME del formato de archivo de datos geográficos que queremos cargar (GeoJSON, KML, etc.).

Si esta propiedad no está definida, si la capa es un mapa de fondo (consultar propiedad isBase), se asume que el formato es image/jpeg, en caso contrario se asume que el formato es image/png.

Para asignar valor a esta propiedad se puede usar las constantes de definidas en SITNA.Consts.mimeType.

hideTree boolean <optional>

Aplicable a capas de tipo WMS y KML. Si se establece a true, la capa no muestra la jerarquía de grupos de capas en la tabla de contenidos ni en la leyenda.

isBase boolean <optional>

Si se establece a true, la capa es un mapa de fondo.

isDefault boolean <optional>

Obsoleta: En lugar de esta propiedad es recomendable usar la propiedad defaultBaseLayerde SITNA.MapOptions.

Si se establece a true, la capa se muestra por defecto si forma parte de los mapas de fondo.

overviewMapLayer LayerOptions | string <optional>

Definición de la capa que se utilizará como fondo en el control de mapa de situación cuando esta capa está de fondo en el mapa principal. Si el valor es de tipo string, tiene que ser un identificador de capas de la API SITNA (un miembro de SITNA.Consts.layer).

La capa del mapa de situación debe ser compatible con el sistema de referencia de coordenadas del mapa principal (ver propiedad crs de SITNA.MapOptions).

stealth boolean <optional>

Si se establece a true, la capa no aparece en la tabla de contenidos ni en la leyenda. De este modo se puede añadir una superposición de capas de trabajo que el usuario la perciba como parte del mapa de fondo.

thumbnail string <optional>

URL de una imagen en miniatura a mostrar en el selector de mapas de fondo.

title string <optional>

Título de capa. Este valor se mostrará en la tabla de contenidos y la leyenda.

type string <optional>

Tipo de capa. Si no se especifica se considera que la capa es WMS. La lista de valores posibles está definida en SITNA.Consts.layerType.

url string <optional>

URL del servicio OGC o del archivo de datos geográficos que define la capa. Propiedad obligatoria en capas de tipo WMS, WMTS, WFS y KML.

En las capas de tipo VECTOR los archivos de datos geográficos soportados son KML, GeoJSON, GPX, GML, WKT y TopoJSON. El formato se deduce de la extensión del nombre de archivo, pero también se puede especificar utilizando la propiedad format.

En el caso de que un fichero KML tenga definido el estilo del bocadillo, este formato será usado al renderizar el bocadillo en visores basados en la API SITNA.

Ejemplos

Ejemplo de uso de la propiedad url - Ver en vivo


<div id="mapa"></div>
<script>
    // Establecemos un layout simplificado apto para hacer demostraciones de controles.
    SITNA.Cfg.layout = "layout/ctl-container";
    // Añadimos el control de tabla de contenidos en la primera posición.
    SITNA.Cfg.controls.TOC = {
        div: "slot1"
    };
    // Añadimos una capa raster desde un servicio WMS y cuatro capas vectoriales
    // a partir de archivos geográficos: GeoJSON, GPX, KML y GML.
    SITNA.Cfg.workLayers = [
        {
            id: "wms",
            title: "Camino de Santiago",
            type: SITNA.Consts.layerType.WMS,
            url: "//idena.navarra.es/ogc/wms",
            layerNames: "IDENA:PATRIM_Lin_CaminoSantR",
            format: SITNA.Consts.mimeType.PNG
        },
        {
            id: "geojson",
            type: SITNA.Consts.layerType.VECTOR,
            url: "data/PARQUESNATURALES.json",
            format: SITNA.Consts.mimeType.GEOJSON
        },
        {
            id: "gpx",
            type: SITNA.Consts.layerType.VECTOR,
            url: "data/CAMINOFRANCES.gpx"
        },
        {
            id: "kml",
            type: SITNA.Consts.layerType.VECTOR,
            url: "data/MUSEOSNAVARRA.kml"
        },
        {
            id: "gml",
            type: SITNA.Consts.layerType.VECTOR,
            url: "data/ESTACIONESTREN.gml"
        },
    ];
    var map = new SITNA.Map("mapa");
</script>

Ejemplo de uso de la propiedad filter - Ver en vivo


<div id="mapa"></div>
<script>
// Establecemos un layout simplificado apto para hacer demostraciones de controles.
SITNA.Cfg.layout = "layout/ctl-container";
// Añadimos el control de tabla de contenidos en la primera posición.
SITNA.Cfg.controls.TOC = {
    div: "slot1"
};
// Añadimos la capa de IDENA de "Estaciones de aforo del Gobierno de Navarra" cuyo titular es "Gobierno de Navarra"
// Y añadimos la capa "Estaciones meteorológicas" de IDENA mostrando solo aquellas que están por encima de 1000 m.
SITNA.Cfg.workLayers = [
    {
        id: "layer1",
        title: "Estaciones de aforo del Gobierno de Navarra",
        type: SITNA.Consts.layerType.WMS,
        url: "//idena.navarra.es/ogc/wms",
        layerNames: "IDENA:HIDROG_Sym_EstacAforo",
        filter: '<ogc:Filter xmlns:ogc="http://www.opengis.net/ogc"><ogc:PropertyIsEqualTo><ogc:PropertyName>TITULAR</ogc:PropertyName><ogc:Literal><![CDATA[Gobierno de Navarra]]></ogc:Literal></ogc:PropertyIsEqualTo></ogc:Filter>'
    },
    {
        id: "layer2",
        title: "Estaciones meteorológicas por encima de 1000m",
        type: SITNA.Consts.layerType.WMS,
        url: "//idena.navarra.es/ogc/wms",
        layerNames: "IDENA:estacMeteor",
        filter: 'ALTITUD>1000'
    }
];
var map = new SITNA.Map("mapa");
</script>

Ejemplo de uso de la propiedad overviewMapLayer - Ver en vivo


<div id="mapa"></div>
<script>
    // Añadimos una capas de fondo con capas asociadas para el mapa de situación
    SITNA.Cfg.baseLayers = [
        {
            id: "hybrid",
            title: "Mapa base/ortofoto",
            type: SITNA.Consts.layerType.WMS,
            url: "//idena.navarra.es/ogc/wms",
            layerNames: "mapaBase_orto",
            thumbnail: "//idena.navarra.es/navegar/api/TC/css/img/thumb-base_ortho.png",
            overviewMapLayer: {
                id: "hybrid_ov",
                type: SITNA.Consts.layerType.WMS,
                url: "//www.ign.es/wms-inspire/ign-base",
                layerNames: "IGNBaseTodo-gris"
            }
        },
        {
            id: "mapbox",
            title: "Mapbox Streets",
            type: SITNA.Consts.layerType.WMTS,
            encoding: SITNA.Consts.WMTSEncoding.RESTFUL,
            url: "//idena.navarra.es/navegar/api/wmts/mapbox/",
            format: SITNA.Consts.mimeType.PNG,
            layerNames: "streets",
            matrixSet: "WorldWebMercatorQuad",
            thumbnail: "//idena.navarra.es/navegar/api/TC/css/img/thumb-mapbox-streets.png",
            overviewMapLayer: SITNA.Consts.layer.CARTO_DARK
        }
    ];
    var map = new SITNA.Map("mapa");
</script>

RasterOptions

Descripción

Opciones de capa raster. Este objeto se utiliza al configurar un mapa, el control del catálogo de capas o como parámetro al añadir una capa.

Propiedades
Nombre Type Atributos Valor por defecto Descripción
id string

Identificador único de capa. No puede haber en un mapa dos capas con el mismo valor de id.

layerNames string

Lista separada por comas de los nombres de capa del servicio OGC.

url string

URL del servicio OGC que define la capa.

filter string <optional>

Filtro en formato GML o CQL. En función del formato especificado, se añade a las peticiones GetMap posteriores el parámetro filter o cql_filter correspondiente.

No se pueden añadir al mapa 2 o más capas del mismo servicio (misma URL), en las cuales se establezcan filtros de tipo distinto. Es decir, no se pueden mezclar filtros CQL y GML en capas del mismo servicio.

format string <optional>

Tipo MIME del formato de archivo de imagen a obtener del servicio.

Si esta propiedad no está definida, entonces si la capa es un mapa de fondo (consultar propiedad isBase), se asume que el formato es image/jpeg, en caso contrario se asume que el formato es image/png.

Para asignar valor a esta propiedad se puede usar las constantes de definidas en SITNA.Consts.mimeType.

hideTree boolean <optional>

Aplicable a capas de tipo WMS. Si se establece a true, la capa no muestra la jerarquía de grupos de capas en la tabla de contenidos ni en la leyenda.

isBase boolean <optional>

Si se establece a true, la capa es un mapa de fondo.

isDefault boolean <optional>

Obsoleta: En lugar de esta propiedad es recomendable usar la propiedad defaultBaseLayerde SITNA.MapOptions.

Si se establece a true, la capa se muestra por defecto si forma parte de los mapas de fondo.

matrixSet string <optional>

Nombre de conjunto de matrices del servicio WMTS. Esta propiedad es obligatoria para capas de tipo WMTS.

overviewMapLayer LayerOptions | string <optional>

Definición de la capa que se utilizará como fondo en el control de mapa de situación cuando esta capa está de fondo en el mapa principal.

thumbnail string <optional>

URL de una imagen en miniatura a mostrar en el selector de mapas de fondo.

title string <optional>

Título de capa. Este valor se mostrará en la tabla de contenidos y la leyenda.

transparent boolean <optional>
true

Indica si la capa tiene transparencia.

type string <optional>

Tipo de capa. Si no se especifica se considera que la capa es WMS. La lista de valores posibles está definida en SITNA.Consts.layerType.


StyleOptions

Descripción

Opciones de estilo de entidades geográficas.

Propiedades
Nombre Type Atributos Descripción
point SITNA.feature.PointStyleOptions <optional>

Opciones de estilo de punto.

line SITNA.feature.PolylineStyleOptions <optional>

Opciones de estilo de línea.

polygon SITNA.feature.PolygonStyleOptions <optional>

Opciones de estilo de polígono.

marker SITNA.feature.MarkerStyleOptions <optional>

Opciones de estilo de marcador (punto de mapa con icono).

cluster SITNA.layer.ClusterStyleOptions <optional>

Opciones de estilo de cluster de puntos. Consultar la propiedad cluster de LayerOptions para saber cómo mostrar clusters.

heatmap SITNA.layer.HeatmapStyleOptions <optional>

Opciones de estilo de mapa de calor.


VectorOptions

Descripción

Opciones de capa vectorial. Este objeto se utiliza al configurar un mapa o el control del catálogo de capas, o como parámetro al añadir una capa.

Propiedades
Nombre Type Atributos Valor por defecto Descripción
id string

Identificador único de capa. No puede haber en un mapa dos capas con el mismo valor de id.

cluster SITNA.layer.ClusterOptions <optional>

La capa agrupa sus entidades puntuales cercanas entre sí en grupos (clusters).

format string <optional>

Tipo MIME del formato de archivo de datos geográficos que queremos cargar (GeoJSON, KML, etc.). Para asignar valor a esta propiedad se pueden usar las constantes definidas en SITNA.Consts.mimeType.

hideTree boolean <optional>

Aplicable a capas de tipo KML. Si se establece a true, la capa no muestra la jerarquía de grupos de capas en la tabla de contenidos ni en la leyenda.

isBase boolean <optional>

Si se establece a true, la capa es un mapa de fondo.

isDefault boolean <optional>

Obsoleta: En lugar de esta propiedad es recomendable usar la propiedad defaultBaseLayerde SITNA.MapOptions.

Si se establece a true, la capa se muestra por defecto si forma parte de los mapas de fondo.

overviewMapLayer SITNA.layer.LayerOptions | string <optional>

Definición de la capa que se utilizará como fondo en el control de mapa de situación cuando esta capa está de fondo en el mapa principal. Si el valor es de tipo string, tiene que ser un identificador de capas de la API SITNA (un miembro de SITNA.Consts.layer).

La capa del mapa de situación debe ser compatible con el sistema de referencia de coordenadas del mapa principal (ver propiedad crs de SITNA.MapOptions).

stealth boolean <optional>

Si se establece a true, la capa no aparece en la tabla de contenidos ni en la leyenda. De este modo se puede añadir una superposición de capas de trabajo que el usuario la perciba como parte del mapa de fondo.

styles SITNA.layer.StyleOptions <optional>

Descripción de los estilos que tendrán las entidades geográficas de la capa.

thumbnail string <optional>

URL de una imagen en miniatura a mostrar en el selector de mapas de fondo.

title string <optional>

Título de capa. Este valor se mostrará en la tabla de contenidos y la leyenda.

type string <optional>
SITNA.Consts.layerType.VECTOR

Tipo de capa. La lista de valores posibles está definida en SITNA.Consts.layerType.

url string <optional>

URL del servicio OGC o del archivo de datos geográficos que define la capa. Propiedad obligatoria en capas de tipo WFS y KML.

Los archivos de datos geográficos soportados son KML, GeoJSON, GPX, GML, WKT y TopoJSON. El formato se deduce de la extensión del nombre de archivo, pero también se puede especificar utilizando la propiedad format.

En el caso de que un fichero KML tenga definido el estilo del bocadillo, este formato será usado al renderizar el bocadillo en visores basados en la API SITNA.


WmsGroupOptions

Descripción

Opciones de grupo de sugerencias de servicios externos WMS.

Propiedades
Nombre Type Descripción
group string

Nombre del grupo de sugerencias. Se mostrará como una sección en la lista de opciones del control.

items Array.<SITNA.layer.WmsOptions>

Lista de sugerencias de servicios externos WMS.


WmsOptions

Descripción

Opciones de sugerencia de servicio externo WMS.

Propiedades
Nombre Type Descripción
name string

Nombre del servicio WMS. Se mostrará como un elemento en la lista de opciones del control.

url string

URL de acceso al servicio WMS.