readme.md

Tabla de contenido

1. Sobre el proyecto
2. Instalación
   • Ejemplo de uso
3. Funciones
   • localizacion
   • buscar
   • consulta
4. Librerias usadas
5. Contacto

Sobre el proyecto

El objetivo de esta libreria es usar la api de sigpac desde cualquier framework de javascript de forma sencilla para poder consultar los datos en tiempo real. Basicamente se ha tratado de extrapolar el funcionamiento de la página oficial a una libreria sencilla de utilizar.

Probada en:

⚠️ IMPORTANTE: Se recomienda usar esta libreria en NodeJS, aunque se puede instalar en react o angular es posible que fallen las cors o de problemas con la libreria proj4.

Instalación

Puede instalar la libreria mediante npm

 npm i sigpac-client

Ejemplo de uso

import Sigpac from 'sigpac-client';

Sigpac.localizacion(capa, {lng: -1.8054282, lat: 38.9598049})
      .then((geojson) => {
          //Tu código
      });

Mediante importación de funciones individuales

import { localizacion } from 'sigpac-client';

localizacion(capa, {lng: -1.8054282, lat: 38.9598049})
.then((geojson) => {
     //Tu código
});

Forma sincrona

import { localizacion } from 'sigpac-client';

let geojson = await localizacion(capa, {lng: -1.8054282, lat: 38.9598049});

Funciones

Se han intentado replicar exactamente las mismas funciones respetando sus nombres para evitar confusiones, asi como sus parametros. Por ejemplo la opción consulta equivale a la función consulta.

localizacion

Devuelve un geojson con los datos de las coordenadas.

Parametros	Tipo	Valores permitidos	Ejemplo	Obligatorio
capa	String	parcela, recinto, declaracion, red_natura, montanera, nitratos, fitosanitarios, pastos_permanentes, e_paisaje_linea, sie, mfe, cp_no_integradas	'parcela'	Si
coords	Object	lat, lng	{ lng: -1.8054282, lat: 38.9598049 }	Si
config	Object	transformCoords, projection, proxy	{ transformCoords: true, projection: 'WGS84', proxy: false }	No

Ejemplo

import { localizacion } from 'sigpac-client';

const coords = {lng: -1.8054282, lat: 38.9598049};

localizacion(capa, coords)
.then((geojson) => {
     //Tu código
});

Sigpac utiliza un sistema de coordenadas distinto al que se suele usar en google maps o cualquier mapa web, por tanto se ha necesitado transformar las coordenadas antes de devolver el geojson. La proyección por defecto es WGS84 (mas info aquí) sin embargo esta se puede cambiar o directamente anular.

import { localizacion } from 'sigpac-client';

const coords = {lng: -1.8054282, lat: 38.9598049};

//Anular transformación de coordenadas
const config = {transformCoords:  false}

localizacion(capa, coords, config)
.then((geojson) => {
     //Tu código
});

import { localizacion } from 'sigpac-client';

const coords = {lng: -1.8054282, lat: 38.9598049};

//Cambiar proyección
const config = {projection: 'EPSG:4326'}

localizacion(capa, coords, config)
.then((geojson) => {
     //Tu código
});

La manipulación de las coordenadas se ha realizado gracias a la libreria proj4js. Más información sobre el nombre de las proyecciones aquí.

buscar

Devuelve un json con la información de forma recursiva a los valores enviados, es decir si se envia como valores la comunidad y la provincia devolverá los municipios. Esta función esta pensada para filtros por tanto lo ideal es hacer peticiones recursivas en el siguiente orden comunidad -> provincia -> municipio -> poligono -> parcela

Parametros	Tipo	Valores permitidos	Ejemplo	Obligatorio
data	Object	comunidad, provincia, municipio, poligono, parcela	{ comunidad: 7, provincia: 2, municipio: 79, poligono: 37, parcela: 22 }	Si
config	Object	proxy	{ proxy: false }	No

Ejemplo

import { buscar } from 'sigpac-client';

let data = { comunidad: 7 };

let provincias = await Sigpac.buscar(data);
data.provincia =  provincias.features[0].properties.codigo;

let municipios = await Sigpac.buscar(data);
data.municipio =  municipios.features[0].properties.codigo;

let poligonos = await Sigpac.buscar(data);
data.poligono =  poligonos.features[0].properties.codigo;
let parcelas = await Sigpac.buscar(data);

data.parcela =  parcelas.features[0].properties.codigo;
let recintos = await Sigpac.buscar(data);
console.log(recintos.features[0].properties)
/**
  {
    dn_pk: '1222533953',
    nombre: 1,
    codigo: 1,
    x1: -1.605634135436811,
    y1: 39.22648224243416,
    x2: -1.6020442700300674,
    y2: 39.22740772865163
  }
 */

El número de las comunidades coinciden con los orginales, los cuales son:

Comunidad	Número
ANDALUCIA	1
ARAGÓN	2
ASTURIAS	3
C. VALENCIANA	17
CANARIAS	5
CANTABRIA	6
CASTILLA-LA MANCHA	7
CASTILLA Y LEÓN	8
CATALUÑA	9
EXTREMADURA	10
GALICIA	11
ILLES BALEARS	4
LA RIOJA	16
MADRID	12
MURCIA	13
NAVARRA	14
PAIS VASCO	15

consulta

Devuelve un json con los datos de la capa (parcela, recinto o declaración). Dependiendo de la capa que se elija es necesario unos parametros u otros.

Parametros	Tipo	Valores permitidos	Ejemplo	Obligatorio
capa	String	parcela, recinto, declaracion	'parcela'	Si
data	Object	parcela: { provincia, agregado, zona, municipio, poligono, parcela } recinto: { provincia, agregado, zona, municipio, poligono, parcela, recinto } declaracion: { lng, lat }	{ provincia: 2, agregado: 0, zona: 0, municipio: 79, poligono: 37, parcela: 22, recinto: 1 }	Si
config	Object	proxy	{ proxy: false }	No

Ejemplo

import { consulta } from 'sigpac-client';

const data = {
               provincia: 2,
               agregado: 0,
               zona: 0,
               municipio: 79,
               poligono: 37,
               parcela: 22,
               recinto: 1
             };

consulta('recinto', data)
.then((json) => {
  //Tu código  
});

import { consulta } from 'sigpac-client';

const data = {
               lng: -1.8054282, 
               lat: 38.9598049
             };

consulta('declaracion', data)
.then((json) => {
  //Tu código  
});

Librerias usadas

• global-mercator
• node-fetch
• proj4
• chai
• mocha

Contacto

Por favor, pongase en contacto conmigo para cualquier problema, duda o sugerencia.

Daniel Cebrián - d.cebrian9@gmail.com