2.1.1.3. Capas rápidas

Las cápas rápidas consisten en una serie de servicios definidos dentro de la API-CNIG que podemos añadir a nuestros mapas sólo indicando el nombre de aquellos que deseemos añadir.

Para consultar aquellos servicios que están dados de alta en capas rápidas podemos hacer uso del método getQuickLayers:

M.getQuickLayers();

Este método devuelve un objeto con todas las definiciones. Además se puede filtrar por nombre. Por ejemplo, si queremos ver la definición del servicio con nombre 'CartografiaRaster_MTN_WMTS':

M.getQuickLayers('CartografiaRaster_MTN_WMTS');

Devuelve: 'WMTS*https://www.ign.es/wmts/mapa-raster?*MTN*GoogleMapsCompatible*MTN*true*image/jpeg'

Igualmente, podemos acceder al servicio de la siguiente forma:

M.getQuickLayers().CartografiaRaster_MTN_WMTS;

Nota: solo se permite filtrar por 1 nombre.

La definición de los servicios pueden estar en formato API-REST o como objeto capa.

Añadir capas rápidas al mapa

Para ello haremos uso del método clásico 'addLayers' con el formato 'QUICK*nombre'. Ejemplo:

mapjs.addLayers('QUICK*MapaBase_CallejeroGris_WMTS');

O haciendo uso del método 'addQuickLayers', en este caso no es necesario especificar 'QUICK'. Ejemplo:

mapjs.addQuickLayers('MapaBase_CallejeroGris_WMTS');

Aunque también se podría indicar el tipo:

mapjs.addQuickLayers('QUICK*municipiosWMS')

Otra posibilidad es añadiéndola en el constructor del mapa. Ejemplo:

layers: ['OSM', 'QUICK*MapaBase_CallejeroGris_WMTS']

Añadir servicios a la lista de capas rápidas

En caso de que el usuario quiera aumentar la lista de capas lo realizará con el siguiente código:

M.addQuickLayers({
    nombre: definición
})

Ejemplo:

M.addQuickLayers({
  municipios_wms: 'WMS*Municipios*http://geostematicos-sigc.juntadeandalucia.es/geoserver/tematicos/wms?*tematicos:Municipios'
});

También es posible crear un fichero JS con el siguiente contenido.

M.addQuickLayers({
  municipios_wms: 'WMS*Municipios*http://geostematicos-sigc.juntadeandalucia.es/geoserver/tematicos/wms?*tematicos:Municipios'
, ...
});

E importarlo después de los ficheros necesarios de la API:

<script type="text/javascript" src="https://componentes.cnig.es/api-core/js/apiign.ol.min.js"></script>
<script type="text/javascript" src="https://componentes.cnig.es/api-core/js/configuration.js"></script>
<script type="text/javascript" src="./quicklayers.js"></script>

Eliminar los servicios de la lista de capas rápidas

En caso de querer definir nuestro propio listado de capas rápidas podemos hacer uso del parámetro force del método 'addQuickLayers'.

M.addQuickLayers({
  nueva definición
}, true); // true para eliminar las capas ya definidas

Ejemplo:

M.addQuickLayers({
  municipios_wms: 'WMS*Municipios*http://geostematicos-sigc.juntadeandalucia.es/geoserver/tematicos/wms?*tematicos:Municipios'
}, true);

Usar las capas rápidas desde API-REST

También se pueden usar las capas rápidas para crear visualizadores por API- REST, para ello se añadiría como parámetro GET en "Layers" la cadena de texto "QUICK" + el nombre de la capa rápida.

Por ejemplo:

https://componentes.cnig.es/api-core/?layers=QUICK*RelieveSombreado_TMS,QUICK*IGNBaseOrto_TMS&center=-616447.7038098746,4491015.287866212&zoom=5