SITNA

Descripción

Espacio de nombres donde se encuentran las clases de la API SITNA.

Clases


new Map( div [, options ] )

Espacios de nombres


control


feature


layer

Miembros


<static> Cfg :SITNA.MapOptions

Descripción

Configuración general de la API. Cualquier llamada a un método o un constructor de la API sin parámetro de opciones toma las opciones de aquí. Hay que tener en cuenta que el archivo config.json de una maquetación puede sobreescribir los valores por defecto de las propiedades de este espacio de nombres (consultar el tutorial Configurar por maquetación para ver instrucciones de uso de maquetaciones).

Ejemplos

Configuración de capas base - Ver en vivo


<div id="mapa"></div>
<script>
    // Establecer un proxy porque se hacen peticiones a otro dominio.
    SITNA.Cfg.proxy = "proxy/proxy.ashx?";

    // Añadir PNOA y establecerla como mapa de fondo por defecto.
    SITNA.Cfg.baseLayers.push({
        id: "PNOA",
        url: "http://www.ign.es/wms-inspire/pnoa-ma",
        layerNames: "OI.OrthoimageCoverage",
        isBase: true
    });
    SITNA.Cfg.defaultBaseLayer = "PNOA";

    var map = new SITNA.Map("mapa");
</script>

Configuración de CRS - Ver en vivo


<div id="mapa"></div>
<script>
    // SITNA.Cfg.baseLayers[0] (capa por defecto) no es compatible con WGS 84, lo cambiamos por SITNA.Consts.layer.IDENA_DYNBASEMAP.
    SITNA.Cfg.baseLayers[0] = SITNA.Consts.layer.IDENA_DYNBASEMAP;
    SITNA.Cfg.defaultBaseLayer = SITNA.Consts.layer.IDENA_DYNBASEMAP;
    
    // WGS 84
    SITNA.Cfg.crs = "EPSG:4326";
    // Coordenadas en grados decimales, porque el sistema de referencia espacial es WGS 84.
    SITNA.Cfg.initialExtent = [-2.848205, 41.789124, -0.321350, 43.557898];
    SITNA.Cfg.maxExtent = [-2.848205, 41.789124, -0.321350, 43.557898];
    
    var map = new SITNA.Map("mapa", {
        // SITNA.Cfg.baseLayers[0] (capa por defecto) no es compatible con WGS 84, establecer la capa SITNA.Consts.layer.IDENA_DYNBASEMAP en el control de mapa de situación.
        controls: {
            overviewMap: {
                layer: SITNA.Consts.layer.IDENA_DYNBASEMAP
            }
        }
    });
</script>

Configuración de capas de trabajo - Ver en vivo


<div id="mapa"></div>
<script>
    // Establecer un proxy porque se hacen peticiones a otro dominio.
    SITNA.Cfg.proxy = "proxy/proxy.ashx?";

    SITNA.Cfg.workLayers = [{
             id: "terremotos",
             title: "Terremotos últimos 365 días",
             type: SITNA.Consts.layerType.WMS,
             url: "https://www.ign.es/wms-inspire/geofisica",
             layerNames: ["Ultimos365dias"]
         }
    ];
    var map = new SITNA.Map("mapa");
</script>

Configuración de uso de proxy


SITNA.Cfg.proxy = ""; // Las peticiones a http://www.otrodominio.com se hacen directamente

SITNA.Cfg.proxy = "/cgi-bin/proxy.cgi?url="; // Las peticiones a http://www.otrodominio.com se convierten en peticiones a /cgi-bin/proxy.cgi?url=http://www.otrodominio.com

<static, readonly> Consts :object

Descripción

Dentro de este objeto estático se definen las constantes de utilidad que utiliza la API SITNA.

Propiedades
Nombre Type Descripción
format object

Colección de tipos de formatos de archivo de utilidad.

Nombre Type Descripción
GEOJSON string

Leer y escribir datos en formato GeoJSON.

GEOPACKAGE string

Leer y escribir datos en formato GeoPackage.

GML string

Leer y escribir datos en formato GML.

GML2 string

Leer y escribir datos en formato GML versión 2.

GML3 string

Leer y escribir datos en formato GML versión 3.

GML32 string

Leer y escribir datos en formato GML versión 3.2.

GPX string

Leer y escribir datos en formato GPX.

JSON string

Leer y escribir datos en formato JSON.

KML string

Leer y escribir datos en formato KML.

KMZ string

Leer y escribir datos en formato KMZ.

SHAPEFILE string

Leer y escribir datos en formato ShapeFile.

TOPOJSON string

Leer y escribir datos en formato TopoJSON.

WKT string

Leer y escribir datos en formato WKT.

ZIP string

Leer y escribir datos archivados en formato ZIP.

geom object

Colección de identificadores de tipo de geometría.

Nombre Type Descripción
POINT string

Identificador de geometría de tipo punto.

POLYLINE string

Identificador de geometría de tipo línea de varios segmentos.

POLYGON string

Identificador de geometría de tipo polígono.

layer object

Colección de identificadores de capas útiles de IDENA y otros servicios de terceros.

Nombre Type Descripción
BLANK string

Identificador de una capa en blanco.

CARTO_DARK string

Identificador de la capa de Carto Dark a través del WMTS de la API SITNA. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

CARTO_LIGHT string

Identificador de la capa de Carto Light a través del WMTS de la API SITNA. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

CARTO_VOYAGER string

Identificador de la capa de Carto Voyager a través del WMTS de la API SITNA. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

IDENA_BASEMAP string

Identificador de la capa de mapa base del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IDENA_BASEMAP_GREY string

Identificador de la capa de mapa base gris del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IDENA_BASEMAP_ORTHOPHOTO string

Identificador de la capa de la combinación de ortofoto de máxima actualidad y mapa base del WMS de IDENA.

IDENA_BW_RELIEF string

Identificador de la capa de relieve en blanco y negro del WMS de IDENA.

IDENA_CADASTER string

Identificador de la capa de catastro del WMS de IDENA.

IDENA_CARTO string

Identificador de la capa de cartografía topográfica del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IDENA_DYNBASEMAP string

Identificador de la capa de mapa base del WMS de IDENA.

IDENA_DYNBASEMAP_GREY string

Identificador de la capa de mapa base gris del WMS de IDENA.

IDENA_DYNCARTO string

Identificador de la capa de cartografía topográfica del WMS de IDENA.

IDENA_DYNORTHOPHOTO string

Identificador de la capa de ortofoto de máxima actualidad del WMS de IDENA.

IDENA_DYNORTHOPHOTO2012 string

Identificador de la capa de ortofoto 2012 del WMS de IDENA.

IDENA_DYNORTHOPHOTO2014 string

Identificador de la capa de ortofoto 2014 del WMS de IDENA.

IDENA_DYNORTHOPHOTO2017 string

Identificador de la capa de ortofoto 2017 del WMS de IDENA.

IDENA_DYNORTHOPHOTO2018 string

Identificador de la capa de ortofoto 2018 del WMS de IDENA.

IDENA_DYNORTHOPHOTO2019 string

Identificador de la capa de ortofoto 2019 del WMS de IDENA.

IDENA_DYNORTHOPHOTO2020 string

Identificador de la capa de ortofoto 2020 del WMS de IDENA.

IDENA_DYNORTHOPHOTO2021 string

Identificador de la capa de ortofoto 2021 del WMS de IDENA.

IDENA_DYNORTHOPHOTO2022 string

Identificador de la capa de ortofoto 2022 del WMS de IDENA.

IDENA_ORTHOPHOTO string

Identificador de la capa de ortofoto de máxima actualidad del WMTS de IDENA. Esta capa solo es compatible con los sistemas de referencia EPSG:25830 y EPSG:4326.

IDENA_ORTHOPHOTO2012 string

Identificador de la capa de ortofoto 2012 del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IDENA_ORTHOPHOTO2014 string

Identificador de la capa de ortofoto 2014 del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IDENA_ORTHOPHOTO2017 string

Identificador de la capa de ortofoto 2017 del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IDENA_ORTHOPHOTO2018 string

Identificador de la capa de ortofoto 2018 del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IDENA_ORTHOPHOTO2019 string

Identificador de la capa de ortofoto 2019 del WMTS de IDENA. Esta capa solo es compatible con los sistemas de referencia EPSG:25830 y EPSG:4326.

IDENA_ORTHOPHOTO2020 string

Identificador de la capa de ortofoto 2020 del WMTS de IDENA. Esta capa solo es compatible con los sistemas de referencia EPSG:25830 y EPSG:4326.

IDENA_ORTHOPHOTO2021 string

Identificador de la capa de ortofoto 2021 del WMTS de IDENA. Esta capa solo es compatible con los sistemas de referencia EPSG:25830 y EPSG:4326.

IDENA_ORTHOPHOTO2022 string

Identificador de la capa de ortofoto 2022 del WMTS de IDENA. Esta capa solo es compatible con los sistemas de referencia EPSG:25830 y EPSG:4326.

IDENA_PAMPLONA_DYNORTHOPHOTO2020 string

Identificador de la capa de ortofoto de la comarca de Pamplona 2020 del WMS de IDENA.

IDENA_PAMPLONA_DYNCARTO string

Identificador de la capa de la cartografía topográfica de Pamplona del WMS de IDENA.

IDENA_PAMPLONA_ORTHOPHOTO2020 string

Identificador de la capa de ortofoto de la comarca de Pamplona 2020 del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IDENA_PAMPLONA_CARTO string

Identificador de la capa de la cartografía topográfica de Pamplona del WMTS de IDENA. Esta capa solo es compatible con el sistema de referencia EPSG:25830.

IGN_ES_BASEMAP string

Identificador de la capa del callejero del WMTS del Instituto Geográfico Nacional.

IGN_ES_BASEMAP_GREY string

Identificador de la capa del callejero en gris del WMTS del Instituto Geográfico Nacional. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

IGN_ES_CARTO string

Identificador de la capa de cartografía raster del WMTS del Instituto Geográfico Nacional.

IGN_ES_DYNBASEMAP string

Identificador de la capa del callejero del WMS del Instituto Geográfico Nacional.

IGN_ES_DYNBASEMAP_GREY string

Identificador de la capa del callejero en gris del WMS del Instituto Geográfico Nacional.

IGN_ES_DYNCARTO string

Identificador de la capa de cartografía raster del WMS del Instituto Geográfico Nacional.

IGN_ES_DYNLIDAR string

Identificador de la capa del modelo digital de superficies LIDAR del WMS del Instituto Geográfico Nacional.

IGN_ES_DYNORTHOPHOTO string

Identificador de la capa del PNOA del WMS del Instituto Geográfico Nacional.

IGN_ES_LIDAR string

Identificador de la capa del modelo digital de superficies LIDAR del WMTS del Instituto Geográfico Nacional.

IGN_ES_ORTHOPHOTO string

Identificador de la capa del PNOA del WMTS del Instituto Geográfico Nacional.

IGN_ES_RELIEF string

Identificador de la capa de relieve del WMTS del Instituto Geográfico Nacional.

IGN_FR_BASEMAP string

Identificador de la capa de mapa base del WMTS del Instituto Geográfico Nacional Francés. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

IGN_FR_DYNBASEMAP string

Identificador de la capa de mapa base del WMS del Instituto Geográfico Nacional Francés.

IGN_FR_DYNORTHOPHOTO string

Identificador de la capa de ortofoto del WMS del Instituto Geográfico Nacional Francés.

IGN_FR_DYNRELIEF string

Identificador de la capa de relieve del WMS del Instituto Geográfico Nacional Francés.

IGN_FR_ORTHOPHOTO string

Identificador de la capa de ortofoto del WMTS del Instituto Geográfico Nacional Francés. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

IGN_FR_RELIEF string

Identificador de la capa de relieve del WMTS del Instituto Geográfico Nacional Francés. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

MAPBOX_SATELLITE string

Identificador de la capa de Mapbox Satellite a través del WMTS de la API SITNA. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

MAPBOX_STREETS string

Identificador de la capa de Mapbox Streets a través del WMTS de la API SITNA. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

OPENTOPOMAP string

Identificador de la capa de OpenTopoMap a través del WMTS de la API SITNA. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

OSM string

Identificador de la capa de OpenStreetMap a través del WMTS de la API SITNA. Esta capa solo es compatible con el sistema de referencia EPSG:3857.

layerType object

Colección de identificadores de tipo de capa.

Nombre Type Descripción
KML string

Obsoleta: En lugar de esta propiedad es recomendable usar SITNA.Consts.layerType.VECTOR para cargar archivos KML.

Identificador de capa de tipo KML.

VECTOR string

Identificador de capa de tipo vectorial. Este tipo de capa es la que se utiliza para representar entidades geográficas de SITNA.feature.

WFS string

Identificador de capa de tipo WFS.

WMS string

Identificador de capa de tipo WMS.

WMTS string

Identificador de capa de tipo WMTS.

mimeType object

Colección de tipos MIME de utilidad.

Nombre Type Descripción
GEOJSON string

Tipo MIME de documento GeoJSON.

GEOPACKAGE string

Tipo MIME de archivo GeoPackage.

GML string

Tipo MIME de documento GML.

GPX string

Tipo MIME de documento GPX.

JPEG string

Tipo MIME de imagen JPEG.

JSON string

Tipo MIME de documento JSON.

KML string

Tipo MIME de documento KML.

KMZ string

Tipo MIME de documento KMZ (KML comprimido en ZIP).

PNG string

Tipo MIME de imagen PNG.

SHAPEFILE string

Tipo MIME de archivo Shapefile.

XML string

Tipo MIME de documento XML.

ZIP string

Tipo MIME de archivo ZIP.

Ejemplos

Paso de constantes como parámetros al constructor de una capa vectorial con un documento KML como fuente de datos.


const myVectorLayer = new SITNA.layer.Vector({
     id: 'myLayer',
     type: SITNA.Consts.layerType.VECTOR,
     format: SITNA.Consts.format.KML,
     url: 'https://sitna.navarra.es/api/examples/data/MUSEOSNAVARRA.kml'
});

Definiciones de tipos


ElevationOptions

Descripción

Opciones de la herramienta de elevación.

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

Distancia máxima en metros entre puntos con elevaciones. Si la distancia entre vértices de la geometría de la que queremos obtener los valores de elevación es mayor que este valor, se añaden puntos intermedios hasta que esa distancia sea menor o igual a este valor.

sampleNumber number <optional>

Número total de puntos de la geometría con elevación.

Si la geometría tiene más puntos que el valor de esta propiedad, se elminarán de manera repartida los puntos sobrantes.

Si la geometría tiene menos puntos que este valor, se insertarán puntos de manera repartida a lo largo de la geometría.

Si esta propiedad entra en conflicto con la propiedad resolution, prevalece resolution.

services Array.<string> | Array.<SITNA.ElevationServiceOptions> <optional>
SITNA.Consts.elevationService.IDENA, SITNA.Consts.elevationService.IGN_FR, SITNA.Consts.elevationService.IGN_ES

Lista priorizada con identificadores de servicio de elevación (miembros de SITNA.Consts.elevationService) u objetos de configuración de servicio a los que se consulta para obtener el dato de elevación. Si varios servicios devuelven un valor válido para un punto, se toma el valor del servicio que esté representado antes en esta lista.


ElevationServiceOptions

Descripción

Opciones de servicio de obtención de elevaciones de puntos.

Propiedades
Nombre Type Atributos Descripción
allowedGeometryTypes Array.<string> <optional>

Si se establece, indica para qué geometrías se van a hacer consultas de elevación al servicio. Esto es conveniente por ejemplo si el servicio solo permite obtener elevaciones de un punto simple, invalidándolo para la consulta si la geometría es un polígono o una línea. Los elementos del array tienen que ser cadenas cuyos valores deben ser los definidos por SITNA.Consts.geom.

googleMapsKey string <optional>

Valor de una clave válida de la API de Google Maps. Solamente es necesaria cuando el valor de la propiedad name es SITNA.Consts.elevationService.GOOGLE.

Puede obtener más información en el sitio para desarrolladores de Google.

name string

Nombre del servicio que queremos utilizar. Debe tener un valor de SITNA.Consts.elevationService.

url string <optional>

URL del servicio. Cada servicio de elevaciones de puntos tiene asignada una URL por defecto, así que rara vez será necesario establecer esta propiedad.


LayoutOptions

Descripción

Opciones de maquetación de mapa (para ver instrucciones de uso de maquetaciones, consultar Configurar por maquetación).

Propiedades
Nombre Type Atributos Descripción
config string <optional>

URL de un archivo de configuración del mapa.

i18n string <optional>

URL de la carpeta donde se encuentran los archivos de textos para internacionalización (Ver la documentación de soporte multiidioma de las maquetaciones).

markup string <optional>

URL de un documento con el HTML a incrustar en el mapa. Necesario para especificar la distribución de controles y elementos de interfaz de usuario.

script string <optional>

URL de un documento JavaScript. Útil para añadir lógica a los elementos de interfaz de usuario que se añaden con la maquetación.

style string <optional>

URL de una hoja de estilos para los elementos de interfaz de usuario que se añaden con la maquetación.

Ejemplos

<div id="mapa"></div>
<script>
    // Instanciamos un mapa cuya maquetación tiene la configuración y el marcado personalizados
    // y el resto de elementos se obtienen de la maquetación por defecto
    var map = new SITNA.Map("mapa", {
        layout: {
            config: "layout/ctl-container/config.json",
            markup: "layout/ctl-container/markup.html",
            style: "//sitna.navarra.es/api/layout/responsive/style.css",
            script: "//sitna.navarra.es/api/layout/responsive/script.js",
            i18n: "//sitna.navarra.es/api/layout/responsive/resources"
        }
    });
</script>

MapOptions

Descripción

Opciones de configuración del mapa. Para más información de como usar objetos de este tipo, consultar 2-configuration.

Propiedades
Nombre Type Atributos Valor por defecto Descripción
baseLayers=[SITNA.Consts.layer.IDENA_BASEMAP, SITNA.Consts.layer.IDENA_ORTHOPHOTO, SITNA.Consts.layer.IDENA_CADASTER, SITNA.Consts.layer.IDENA_CARTO] Array.<LayerOptions> | Array.<string>

Lista con cualquier combinación de objetos de definición de capa o de identificadores de capas de la API SITNA (miembros de SITNA.Consts.layer) para incluir dichas capas como mapas de fondo.

controls SITNA.control.MapControlOptions <optional>

Opciones de controles de mapa, define qué controles se incluyen en un mapa y qué opciones se pasan a cada control.

crossOrigin string <optional>

Valor del atributo crossorigin de las imágenes del mapa para habilitar CORS. Es necesario establecer esta opción para poder utilizar el método SITNA.Map#exportImage.

Los valores soportados son anonymous y use-credentials. Para más información, consulte la documentación de MDN Web Docs.

crs string <optional>
"EPSG:25830"

Código EPSG del sistema de referencia de coordenadas del mapa.

defaultBaseLayer string <optional>
SITNA.Consts.layer.IDENA_BASEMAP

Identificador de la capa base por defecto o índice de la capa base por defecto en la lista de capas base del mapa (Definida con la propiedad baseLayers).

initialExtent Array.<number> <optional>
[541084.221, 4640788.225, 685574.4632, 4796618.764]

Extensión inicial del mapa definida por x mínima, y mínima, x máxima, y máxima, en las unidades del sistema de referencia de coordenadas del mapa (Ver propiedad crs). Por defecto la extensión es la de Navarra.

layout string | SITNA.LayoutOptions <optional>
"//sitna.navarra.es/api/layout/responsive"

URL de la carpeta de maquetación u objeto de opciones de maquetación. Para prescindir de maquetación, establecer esta propiedad a null. Para más información al respecto de esta propiedad, consulte el tutorial Configurar por maquetación.

locale string <optional>
"es-ES"

Código de idioma de la interfaz de usuario. Este código debe obedecer la sintaxis definida por la IETF. Los valores posibles son es-ES, eu-ES y en-US.

maxExtent Array.<number> | boolean <optional>
false

Extensión máxima del mapa definida por x mínima, y mínima, x máxima, y máxima, de forma que el centro del mapa nunca saldrá fuera de estos límites. Estos valores deben estar en las unidades definidas por el sistema de referencia de coordenadas del mapa (Ver propiedad crs).

Si en vez de un array el valor es false, el mapa no tiene limitada la extensión máxima.

mouseWheelZoom boolean <optional>
true

Si se establece a un valor verdadero, la rueda de scroll del ratón se puede utilizar para hacer zoom en el mapa.

stateful boolean <optional>
false

Si se establece a un valor verdadero, el mapa mantiene un historial de estados añadiendo a la URL de la aplicación que lo contiene un código hash.

Con esta opción activa, el mapa puede pasar al estado previo o siguiente con los botones de historial del navegador. Así mismo, si se recarga la página el mapa conservará el estado en el que se encontraba.

pixelTolerance number <optional>
10

Tolerancia en pixels a las consultas de información de capa.

En ciertas capas, por ejemplo las que representan geometrías de puntos, puede ser difícil pulsar precisamente en el punto donde está la entidad geográfica que interesa.

La propiedad pixelTolerance define un área de un número de pixels hacia cada lado del punto de pulsación, de forma que toda entidad geográfica que esté dentro de ese área, total o parcialmente, se incluye en el resultado de la consulta.

Por ejemplo, si el valor establecido es 10, toda entidad geográfica que esté dentro de un cuadrado de 21 pixels de lado (10 pixels por cuadrante más el pixel central) centrado en el punto de pulsación se mostrará en el resultado. A tener en cuenta: Esta propiedad establece el valor de los llamados parámetros de vendedor que los servidores de mapas admiten para modificar el comportamiento de las peticiones getFeatureInfo del standard WMS. Pero este comportamiento puede ser modificado también por otras circunstancias, como los estilos aplicados a las capas en el servidor.

Como estas circunstancias están fuera del ámbito de alcance de esta API, es posible que los resultados obtenidos desde algún servicio WMS sean inesperados en lo referente a pixelTolerance.

proxy string <optional>

URL del proxy utilizado para peticiones a dominios remotos.

Debido a restricciones de seguridad implementadas en Javascript, a través de XMLHttpRequest no es posible obtener información de dominios distintos al de la página web.

Hay dos maneras de solventar esta restricción. La primera es que el servidor remoto permita el acceso entre dominios estableciendo la cabecera Access-Control-Allow-Origin a la respuesta HTTP. Dado que esta solución la implementan terceras personas (los administradores del dominio remoto), no siempre es aplicable.

La segunda solución es desplegar en el dominio propio un proxy. Un proxy es un servicio que recibe peticiones HTTP y las redirige a otra URL.

Si la propiedad proxy está establecida, todas las peticiones a dominios remotos las mandará al proxy para que este las redirija. De esta manera no infringimos las reglas de seguridad de JavaScript, dado que el proxy está alojado en el dominio propio.

styles SITNA.layer.StyleOptions <optional>

Opciones de estilo de las entidades geográficas.

views SITNA.MapViewOptions <optional>

Opciones de vistas de mapa, define qué vistas estarán disponibles para conmutar entre el mapa y las vistas adicionales configuradas aquí, y qué opciones se pasan a cada vista. Actualmente, únicamente existe la opción de configurar la vista threed que gestiona el control threed de SITNA.control.MapControlOptions.

workLayers Array.<LayerOptions> <optional>

Lista de objetos de definición de capa para incluir dichas capas como contenido activo del mapa.

Detalles

2-configuration


MapViewOptions

Descripción

Opciones de vistas de mapa, define qué vistas estarán disponibles para conmutar entre el mapa y las vistas adicionales configuradas aquí, y qué opciones se pasan a cada vista. Actualmente, únicamente existe la opción de configurar la vista threed que gestiona el control threed de SITNA.control.MapControlOptions.

Propiedades
Nombre Type Atributos Descripción
threeD SITNA.ThreeDViewOptions <optional>

Se establece un valor truthy con las opciones de la vista del mapa.

Ejemplos

Definición objeto SITNA.MapViewOptions


    { 
        threeD: { }
    }            

<div id="mapa"/>
<div id="vista3d"/>
<script>
    // Configuración adicional de una vista en la cual se renderizará la vista 3D.
    SITNA.Cfg.views = { // Establecemos la propiedad `views` del mapa indicando como valor un objeto con la estructura definida en `SITNA.MapViewOptions`.
        threeD: { // Establecemos la propiedad `threeD` configurando como valor un objeto siguiendo la estructura de `SITNA.ThreeDViewOptions`.
            div: "vista3d" // Indicamos el identificador del DIV en el marcado en el cual cargar la vista 3D.
        }
    };
</script>
Detalles

SearchResultItem

Descripción

Objeto proporcionado en las respuestas a peticiones de datos de búsqueda (SITNA.Map#getMunicipalities, etc.).

Propiedades
Nombre Type Descripción
id string

Identificador del elemento a buscar.

label string

Texto descriptivo del elemento a buscar que se mostrará en la lista de sugerencias de resultados de búsqueda.


ThreeDViewOptions

Descripción

Configuración adicional necesaria del control 3D en el mapa. Se define el elemento del DOM en el cual se renderizará la vista 3D.

Propiedades
Nombre Type Atributos Descripción
div HTMLElement | string <optional>

Elemento del DOM en el que crear la vista o valor de atributo id de dicho elemento.

Ejemplos

Definición de objeto SITNA.ThreeDViewOptions


    {  
        div: "IDElementoDOM"
    }

<div id="mapa"/>
<div id="vista3d"/>
<script>
    // Establecemos un layout simplificado apto para hacer demostraciones de controles.
    SITNA.Cfg.layout = "layout/ctl-container";
    // Configuramos en la propiedad `views` del mapa, la vista `threeD` que requiere el control threeD para el correcto funcionamiento.
    SITNA.Cfg.views = {
        threeD: {
            div: "vista3d" // Indicamos el identificador del DIV en el marcado en el cual cargar la vista 3D.
        }
    };
    // Añadimos el control 3D.
    SITNA.Cfg.controls.threeD = true;  
    // Añadimos el control de selector de mapas de fondo en el primer DIV del marcado markup.html contenido en el layout configurado en la propiedad SITNA.Cfg.layout.
    SITNA.Cfg.controls.basemapSelector = {
        div: "slot1"
    };
    // Añadimos el control de tabla de contenidos en el segundo DIV del marcado markup.html contenido en el layout configurado en la propiedad SITNA.Cfg.layout.
    SITNA.Cfg.controls.TOC = {
        div: "slot2"
    };
    // Añadimos una capa raster desde un servicio WMS y una capa vectorial
    // a partir de un archivo geográfico en formato 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: "gml",
            type: SITNA.Consts.layerType.VECTOR,
            url: "data/ESTACIONESTREN.gml"
        }
    ];  
    var map = new SITNA.Map("mapa");
</script>
Detalles