WFS

WFS (Web Feature Service) es un estándar OGC para la descarga y transferencia de información geográfica, donde los elementos geográficos o features se transmiten en su totalidad al cliente.

Para visualizar capas WFS en la API, se pueden:

1.- Añadir en el constructor del mapa, tanto en modo cadena como objeto:

// Ejemplo de capas WFS en modo cadena 
const mapajs = M.map({
  container: "map",
  center: { x: -965497.2717184591, y: 4166095.580546307 },
  zoom: 5,
  controls: ['backgroundlayers'],
  layers: ["WFST*Campamentos*http://geostematicos-sigc.juntadeandalucia.es/geoserver/sepim/ows?*sepim:campamentos*MPOINT"]
});

2.- O añadiéndolas con el método correspondiente:

//modo objeto
const layer = new M.layer.WFS({
  url: "http://geostematicos-sigc.juntadeandalucia.es/geoserver/tematicos/ows?",
  namespace: "tematicos",
  name: "Provincias",
  legend: "Provincias",
  geometry: 'MPOLYGON',
  ids:"3,4"
});
mapajs.addWFS(layer);

//modo cadena
mapajs.addWFS('WFST*Campamentos*http://geostematicos-sigc.juntadeandalucia.es/geoserver/sepim/ows?*sepim:campamentos*MPOINT');

Donde:

url: url del servicio WFS.
namespace: workspace asociado a la capa.
name: nombre de la capa en el servidor.
legend: indica el nombre que queremos que aparezca en el árbol de contenidos, si lo hay.
geometry: Tipo de geometría: POINT, MPOINT, LINE, MLINE, POLYGON o MPOLYGON.
ids: Opcional - identificadores por los que queremos filtrar los features.
cql: Opcional - Sentencia CQL para filtrar los features. El método setCQL(cadena_cql) refresca la capa aplicando el nuevo predicado CQL que reciba.
maxExtent: Restringe la visibilidad de la capa a una extensión.
version: Opcional - Versión del estandar a usar. Por defecto es 1.0.0.
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 WFS 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: Estas opciones se mandarán a la implementación de la capa.
- 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.
- getFeatureOutputFormat: Formato de los objetos geográficos, por defecto 'application/json'.
- describeFeatureTypeOutputFormat: Describe el formato de salida de los objetos geográficos.
- vendor: Proveedor.
- minZoom: Zoom mínimo aplicable a la capa.
- maxZoom: Zoom máximo aplicable a la capa.
- visibility: Define si la capa es visible o no. Verdadero por defecto.
- displayInLayerSwitcher: Indica si la capa se muestra en el selector de capas.
- opacity: Opacidad de capa, por defecto 1.
vendorOpts: 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 WFS:

const layer = new M.layer.WFS({
  url: "http://geostematicos-sigc.juntadeandalucia.es/geoserver/tematicos/ows?", 
  namespace: "tematicos",
  name: "Provincias",
  legend: "Provincias",
  geometry: 'MPOLYGON',
  ids: "3,4"
}, {
  // aplica un estilo a la capa
 style: new M.style.Polygon({
    fill: {
      color: 'red'
    }
  }),
  visibility: false // capa no visible en el mapa
}, {
  opacity: 0.5 // aplica opacidad a la capa
});

Formato de salida
La API pide las capas WFS al servidor OGC en formato geojson usando por defecto como outputFormat 'application/json'. Sin embargo, en función del tipo de servidor OGC que esté atendiendo las peticiones (Geoserver, Mapserver, etc.), puede que tenga asignando un nombre diferente. En ese caso, se puede establecer el valor del outputFormat para las peticiones getFeature y describeFeature, usando las opciones de usuario 'getFeatureOutputFormat' y 'describeFeatureTypeOutputFormat':

lAguasSupRediam = new M.layer.WFS({
  url: 'http://www.juntadeandalucia.es/medioambiente/mapwms/REDIAM_WFS_RN_Aguas?bbox=508887.12101065,4131323.42844933,509462.159552335,4131744.12235486',
  legend: 'Cursos de Agua Rediam',
  name: 'a_red_hidrografica',
  geometry: 'MLINE'
}, {
  getFeatureOutputFormat: 'geojson',
  describeFeatureTypeOutputFormat: 'geojson'
});

Parámetros vendor
Algunos servidores de mapas son capaces de procesar en las peticiones OGC parámetros adicionales propios, conocidos como vendor parameters. En las capas WFS podemos especificar cualquier parámetro de este tipo si lo incluimos dentro de la estructura correspondiente en el segundo parámetro del constructor: 'vendor -> request OGC asociado -> parametro:valor', por ejemplo:

const lAguasSupRediam = new M.layer.WFS({
  url: 'http://www.juntadeandalucia.es/medioambiente/mapwms/REDIAM_WFS_RN_Aguas?bbox=508887.12101065,4131323.42844933,509462.159552335,4131744.12235486',
  legend: 'Cursos de Agua Rediam',
  name: 'a_red_hidrografica',
  geometry: 'MLINE'
 },{
  vendor:{
    getFeature: {
       'parametro1': 'valor1',
       'parametro2': 'valor2'
    }
 }
});

El ejemplo anterior crearía peticiones getFeatures que incluirían los parámetros vendor especificados:

http://...?request=getFeature&....&parametro1=valor1&parametro2=valor2

Ejemplo completo de vendor:

        const provincia = new M.layer.WFS({
            url: "https://sig.asturias.es/servicios/services/UnidadesAdministrativas/MapServer/WFSServer",
            namespace: "UnidadesAdministrativas",
            name: "Asturias",
            legend: "Provincia",
            geometry: 'POLYGON',
            version:'2.0.0'
        }, {
            vendor: {
                getFeature: {
                    'outputFormat': 'GEOJSON' // añadirá a la petición getFeature el parámetro outputFormat con valor GEOJSON
                }
            }
        });