Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/danizd/geoviable/llms.txt

Use this file to discover all available pages before exploring further.

GeoViable cross-references every parcel against 7 official environmental data layers published by the Spanish government ministries MITECO (Ministerio para la Transición Ecológica y el Reto Demográfico) and CNIG (Centro Nacional de Información Geográfica). Each layer is stored in a dedicated PostGIS table, filtered to the Galicia region, and kept up to date via an automated monthly pipeline. Together they cover the full range of environmental constraints that can affect land-use feasibility in Galicia.

Layer Overview

#Layer (display name)SourceUpdate frequencyTable
1Red Natura 2000 (ZEPA + LIC/ZEC)MITECOAnnualred_natura_2000
2Zonas inundables (SNCZI) T100+T500MITECOIrregularzonas_inundables
3Dominio Público HidráulicoMITECOIrregulardominio_publico_hidraulico
4Vías pecuariasCNIGAnnualvias_pecuarias
5Espacios Naturales ProtegidosMITECOAnnualespacios_naturales_protegidos
6Masas de agua superficialesMITECOPHC cycle (6 years)masas_agua_superficial
7Masas de agua subterráneasMITECOPHC cycle (6 years)masas_agua_subterranea

Layer Details

Red Natura 2000 is the European Union’s network of conservation areas. GeoViable stores both sub-types: ZEPA (Zona de Especial Protección para las Aves — bird protection) and LIC/ZEC (Lugar de Importancia Comunitaria / Zona de Especial Conservación — habitat protection). Overlap with these areas triggers strict land-use scrutiny under EU Habitats Directive assessment requirements.
FieldValue
SourceMITECO Banco de Datos de Naturaleza
Download pagehttps://www.miteco.gob.es/es/biodiversidad/servicios/banco-datos-naturaleza/informacion-disponible/rednatura_2000_desc.html
Source CRSEPSG:4258 (ETRS89) — reprojected to EPSG:25830 on load
Geometry typeGEOMETRY(MultiPolygon, 25830)
Update frequencyAnnual
Key attributes
ColumnTypeDescription
codigoVARCHAR(20)Official site code (e.g. ES1110006)
nombreVARCHAR(255)Official site name
tipoVARCHAR(10)ZEPA | LIC | ZEC
superficie_haNUMERIC(12,2)Official area in hectares
Risk significance: Any overlap with Red Natura 2000 is evaluated in the overall risk model. If overlap is ≥ 50 % of the parcel area, the layer contributes an alto trigger. If 3 or more layers are affected simultaneously, the result is also alto regardless of overlap percentage. Smaller overlaps (< 10 %) with no other high-severity layers yield bajo; overlaps ≥ 10 % yield medio.
Official flood zone mapping produced by the Sistema Nacional de Cartografía de Zonas Inundables (SNCZI). GeoViable stores zones for two statistical return periods: T100 (100-year flood) and T500 (500-year flood). Both are loaded into the same table and distinguished by the periodo_retorno column.
FieldValue
SourceMITECO SNCZI download portal
Download pagehttps://www.miteco.gob.es/es/cartografia-y-sig/ide/descargas/agua/descargas_agua_snczi.html
Source CRSEPSG:25830 (no reprojection needed)
Geometry typeGEOMETRY(MultiPolygon, 25830)
Update frequencyIrregular
Demarcaciones loadedGalicia-Costa, Miño-Sil
Key attributes
ColumnTypeDescription
periodo_retornoVARCHAR(10)T100 | T500
nivel_peligrosidadVARCHAR(50)Hazard level classification
demarcacionVARCHAR(100)Hydrographic demarcation
Risk significance: Any overlap with a T100 flood zone triggers muy alto — the highest level in GeoViable’s risk model. T500-only overlap without any other high-severity layer is evaluated by the general overlap rules (bajo / medio / alto depending on percentage and total layers affected).
The Dominio Público Hidráulico (DPH) is the state-owned hydraulic public domain: it comprises the beds, banks, and margins of rivers and streams as defined under Spain’s Ley de Aguas. Construction within the DPH or its protective zones is subject to very strict restrictions.
FieldValue
SourceMITECO
Download pagehttps://www.miteco.gob.es/es/cartografia-y-sig/ide/descargas/agua/dph-y-zonas-asociadas.html
Source CRSEPSG:25830
Geometry typeGEOMETRY(MultiPolygon, 25830)
Update frequencyIrregular
Demarcaciones loadedGalicia-Costa, Miño-Sil
Key attributes
ColumnTypeDescription
tipoVARCHAR(50)cauce | ribera | margen
nombre_cauceVARCHAR(255)Name of the river or stream
categoriaVARCHAR(100)Segment classification
Risk significance: Any overlap with DPH — regardless of overlap percentage — triggers muy alto, the highest level in GeoViable’s risk model.
Vías pecuarias are traditional livestock droving routes protected under Spain’s Ley de Vías Pecuarias (Ley 3/1995). They are classified by width into four types: cañada real (≥ 75.22 m), cordel (≥ 37.61 m), vereda (≥ 20.89 m), and colada (locally determined width). Importantly, Galicia has very few formally demarcated livestock paths — this layer may contain only a small number of features or none at all for many municipalities.
FieldValue
SourceCNIG Centro de Descargas
Download pagehttps://centrodedescargas.cnig.es/CentroDescargas/
Source CRSEPSG:4258 (ETRS89) — reprojected to EPSG:25830 on load
Geometry typeGEOMETRY(MultiLineString, 25830)
Update frequencyAnnual
Key attributes
ColumnTypeDescription
nombreVARCHAR(255)Name of the route
tipo_viaVARCHAR(100)cañada | cordel | vereda | colada
anchura_legal_mNUMERIC(6,2)Legal width in metres
longitud_mNUMERIC(12,2)Total length in metres
estado_deslindeVARCHAR(50)deslindada | sin_deslindar | parcial
municipioVARCHAR(100)Municipality
provinciaVARCHAR(50)Province
Intersection geometry note: Because the features are stored as lines, the spatial analysis service applies ST_Buffer(vp.geom, vp.anchura_legal_m / 2) at query time to construct a virtual corridor polygon whose width matches the legal width of the route before computing overlap with the parcel.
Espacios Naturales Protegidos (ENP) are nationally designated protected natural spaces, including National Parks, Natural Parks, Nature Reserves, and Natural Monuments, regulated under Spain’s Ley 42/2007 del Patrimonio Natural y de la Biodiversidad.
FieldValue
SourceMITECO Banco de Datos de Naturaleza
Download pagehttps://www.miteco.gob.es/es/biodiversidad/servicios/banco-datos-naturaleza/informacion-disponible/enp_descargas.html
Source CRSEPSG:4258 (ETRS89) — reprojected to EPSG:25830 on load
Geometry typeGEOMETRY(MultiPolygon, 25830)
Update frequencyAnnual
Key attributes
ColumnTypeDescription
codigoVARCHAR(20)Official ENP code
nombreVARCHAR(255)Space name
categoriaVARCHAR(100)Parque Nacional | Parque Natural | Reserva | Monumento Natural | …
subcategoriaVARCHAR(100)Sub-category if applicable
superficie_haNUMERIC(12,2)Official area in hectares
Risk significance: ENP overlap ≥ 50 % of the parcel area triggers alto. As with Red Natura 2000, if 3 or more layers are simultaneously affected the result is also alto. Smaller overlaps are assessed by the general overlap thresholds (bajo < 10 %, medio ≥ 10 %).
Surface water bodies from the current hydrological plan cycle (PHC 2022-2027), covering rivers, lakes, reservoirs, coastal waters, and transitional waters within the Galicia-Costa and Miño-Sil demarcations. Because rivers are represented as LineString and lakes/reservoirs as Polygon in the source shapefiles, this table uses a generic Geometry type rather than a specific MultiPolygon or LineString type.
FieldValue
SourceMITECO
Download pagehttps://www.miteco.gob.es/es/cartografia-y-sig/ide/descargas/agua/masas-de-agua-phc-2022-2027.html
Source CRSEPSG:25830
Geometry typeGEOMETRY(Geometry, 25830) — mixed Polygon and LineString
Update frequencyPHC cycle (every 6 years)
Key attributes
ColumnTypeDescription
codigo_masaVARCHAR(100)Water body code
nombreVARCHAR(255)Water body name
tipoVARCHAR(100)río | lago | embalse | costera | transición
estado_ecologicoVARCHAR(50)bueno | moderado | deficiente | malo
estado_quimicoVARCHAR(50)bueno | no alcanza buen estado
demarcacionVARCHAR(100)Hydrographic demarcation
Groundwater bodies (aquifers) from the PHC 2022-2027 cycle. This layer covers the main aquifer systems within Galicia’s hydrographic demarcations. With only around 74 features at the national level, the Galicia bounding-box filter is sufficient to isolate the relevant records.
FieldValue
SourceMITECO
Download pagehttps://www.miteco.gob.es/es/cartografia-y-sig/ide/descargas/agua/masas-de-agua-phc-2022-2027.html
Source CRSEPSG:25830
Geometry typeGEOMETRY(MultiPolygon, 25830)
Update frequencyPHC cycle (every 6 years)
Key attributes
ColumnTypeDescription
codigo_masaVARCHAR(100)Groundwater body code
nombreVARCHAR(255)Body name
estado_cuantitativoVARCHAR(50)bueno | malo
estado_quimicoVARCHAR(50)bueno | malo
superficie_km2NUMERIC(10,2)Area in km²
demarcacionVARCHAR(100)Hydrographic demarcation

Risk Scoring Model

GeoViable assigns one of five risk levels to every analysis result. The rules below are applied in strict priority order by spatial_analysis.py’s _compute_overall_risk function — the first matching rule wins.
PriorityConditionRisk level
1No layers affectedninguno
2Any overlap with Dominio Público Hidráulicomuy alto
2Any overlap with a T100 flood zonemuy alto
33 or more layers affected simultaneouslyalto
3Red Natura 2000 or ENP overlap ≥ 50 % of parcel areaalto
4Maximum overlap across all affected features ≥ 10 %medio
5Maximum overlap < 10 % (1–2 layers affected)bajo
Priority 2 rules (DPH and T100) are checked before all others. A parcel that intersects both DPH and a T100 zone still returns muy alto. T500-only flood zone overlap without DPH falls through to priority 3–5. The risk level is a property of the full analysis result — individual layer accordions above describe how each layer contributes a trigger.

Geographic Scope

All layers are spatially filtered to the Galicia bounding box before being stored in the database:
ParameterValue
Bounding box (WGS84 / EPSG:4326)[-9.5, 41.5, -6.5, 44.0] (minX, minY, maxX, maxY)
Storage CRSEPSG:25830 (ETRS89 / UTM zone 30N)
Primary hydrographic demarcationsGalicia-Costa, Miño-Sil
Secondary demarcations (minor coverage)Cantábrico Occidental, Duero
All geometries are stored in EPSG:25830 (ETRS89 / UTM zone 30N). Source data arriving in EPSG:4258 (ETRS89 geographic) is automatically reprojected to EPSG:25830 during the load pipeline. Source data already in EPSG:25830 (flood zones, DPH, water masses) is loaded without reprojection.
To check current record counts and the last successful update timestamp for each layer, call GET /api/v1/layers/status. A count of 0 for any layer indicates that the table has not been loaded yet or that the most recent update failed — check layer_update_log for details.

Build docs developers (and LLMs) love