Cliente para la API de SIGPAC
npm install sigpac-clientProbada en:
[![Nodejs]][Nodejs-url]
> ⚠️ 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.
Puede instalar la libreria mediante npm
``sh`
npm i sigpac-client
js
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
`js
import { localizacion } from 'sigpac-client';localizacion(capa, {lng: -1.8054282, lat: 38.9598049})
.then((geojson) => {
//Tu código
});
`Forma sincrona
`jsimport { 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.
$3
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 } | NoEjemplo
`js
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.
`js
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
});
`
`js
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í.
$3
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 } | NoEjemplo
`js
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$3
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 } | NoEjemplo
`js
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
});
`
`js
import { consulta } from 'sigpac-client';const data = {
lng: -1.8054282,
lat: 38.9598049
};
consulta('declaracion', data)
.then((json) => {
//Tu código
});
``* global-mercator
* node-fetch
* proj4
* chai
* mocha
Daniel Cebrián - d.cebrian9@gmail.com
[Nodejs]: https://img.shields.io/badge/Nodejs-20232A?style=for-the-badge&logo=nodedotjs&logoColor=green
[Nodejs-url]: https://nodejs.org/es/
[React.js]: https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB
[React-url]: https://reactjs.org/