Comprovar una finca abans de comprar-la
De l'adreça de l'anunci al que diu el Cadastre i al que es veu des del satèl·lit: quina finca és, què hi ha a dins, si cau en un espai protegit i si el terreny es mou. Cada pas fa servir una finca diferent per mostrar un cas amb dades; en el teu flux és la mateixa referència de principi a fi.
Països: ES
1. De l'adreça a la finca
L'adreça en text lliure retorna candidats ordenats per confiança (de 0 a 1) amb la referència de 14 caràcters, l'ús, els habitatges i l'any. Per sobre de 0,75 coincideixen el número i el municipi. Costa 1 unitat només si hi ha candidats.
curl -G "https://api.parcelgps.com/v1/search/address/candidates" \
--data-urlencode "q=Avenida José Rodríguez de la Borbolla Camoyán 10, Dos Hermanas" \
--data-urlencode "limit=3" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Resposta real
{
"success": true,
"data": {
"query": {
"text": "Avenida José Rodríguez de la Borbolla Camoyán 10, Dos Hermanas",
"street": "Avenida José Rodríguez de la Borbolla Camoyán",
"number": 10,
"municipality": "Dos Hermanas"
},
"candidates": [
{
"reference": "0745901TG4304N",
"country": "ES",
"address": "AVENIDA JOSE RGUEZ BORBOLLA CAMOY 10",
"number": 10,
"postalCode": "41704",
"municipality": "Dos Hermanas",
"region": "Sevilla",
"latitude": 37.31947088654626,
"longitude": -5.926788955974699,
"confidence": 0.93,
"numberMatches": true,
"municipalityMatches": true,
"inOwnCopy": true,
"cadastreAddress": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"use": "Residencial",
"dwellings": 346,
"yearBuilt": 2023
},
{
"reference": "0747201TG4304N",
"country": "ES",
"address": "BULEVAR JOSE RODRIGUEZ DE LA BORBOLLA CAMOYAN 11",
"number": 11,
"confidence": 0.55,
"numberMatches": false,
"municipalityMatches": true,
"inOwnCopy": true
}
],
"attribution": "CartoCiudad (Instituto Geográfico Nacional) y Dirección General del Catastro"
},
"remainingSearches": 2894
}2. Què hi ha a dins: habitatges, locals i annexos
Amb la referència de 14 caràcters surten totes les unitats de la finca amb ús, superfície, planta, porta i coeficient de participació. Serveix per comprovar que la superfície i l'ús de l'anunci coincideixen amb el Cadastre. Costa 1 unitat per unitat servida.
curl "https://api.parcelgps.com/v1/parcels/0745901TG4304N/units" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Resposta real
HTTP/2 200
etag: "5ab6bd3d95f85dddba81818bcb0cb65e"
cache-control: private, max-age=21600
x-quota-remaining: 2893
{
"success": true,
"data": {
"reference": "0745901TG4304N",
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"postalCode": "41704",
"municipality": "DOS HERMANAS",
"region": "Sevilla",
"mainUse": "Residencial",
"totalArea": 32789,
"yearBuilt": 2023,
"unitCount": 200,
"propertyUnitCount": 365,
"units": [
{
"reference": "0745901TG4304N0002KH",
"staircase": "",
"floor": "01",
"door": "B",
"use": "Residencial",
"area": 155,
"description": "Planta 01, Pta. B - Residencial",
"ownershipShare": 0.279543,
"yearBuilt": 2023,
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10 Pl:01 Pt:B"
},
{
"reference": "0745901TG4304N0003LJ",
"staircase": "",
"floor": "01",
"door": "C",
"use": "Residencial",
"area": 163,
"description": "Planta 01, Pta. C - Residencial",
"ownershipShare": 0.293879,
"yearBuilt": 2023,
"address": "AV JOSE RGUEZ BORBOLLA CAMOY 10 Pl:01 Pt:C"
}
],
"truncated": true,
"nextCursor": "0745901TG4304N0201MZ",
"dataSource": "clone",
"dataDate": "2026-01-23",
"attribution": "Dirección General del Catastro"
},
"remainingSearches": 2893
}3. Espais protegits: Natura 2000 i parcs
Abans de comprar sòl rústic convé saber si cau dins d'un espai protegit: limita el que s'hi pot construir o plantar. /terrain creua el contorn de la parcel·la amb Natura 2000 i els espais nacionals (CDDA) i diu quina part de la parcel·la queda dins. Exemple real: una parcel·la sencera dins del Parc Nacional de Monfragüe.
curl "https://api.parcelgps.com/v1/parcels/10194A00110004/terrain?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Resposta real, retallada
{
"success": true,
"data": {
"reference": "10194A00110004",
"country": "ES",
"protectedAreas": {
"status": "ok",
"intersects": true,
"inside": true,
"maxOverlapPct": 100,
"natura2000": [
{
"code": "ES0000014",
"name": "Monfragüe y las Dehesas del Entorno",
"type": "SPA",
"country": "ES",
"overlapPct": 100
},
{
"code": "ES4320077",
"name": "Monfragüe",
"type": "SCI",
"country": "ES",
"overlapPct": 100
}
],
"national": [
{
"code": "4820",
"name": "Monfragüe",
"designation": "National Park",
"country": "ES",
"overlapPct": 100
}
],
"method": "parcel",
"sources": [
{
"name": "Natura 2000",
"license": "CC BY 4.0",
"edition": "end 2024"
},
{
"name": "Nationally designated areas (CDDA)",
"license": "CC BY 4.0",
"edition": "2025"
}
]
}
}
}4. Si el terreny s'enfonsa
/ground-motion dona la velocitat vertical del terreny mesurada pel radar de Sentinel-1 (Copernicus EGMS, 2020-2024) sobre la parcel·la. Exemple real: una parcel·la de Múrcia que baixa 40,9 mm l'any, classe severe_subsidence. Si el satèl·lit no té reflectors (camp obert, bosc, aigua), respon status no_data en lloc d'inventar.
curl "https://api.parcelgps.com/v1/parcels/30024A16000286/ground-motion?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Resposta real
{
"success": true,
"data": {
"reference": "30024A16000286",
"country": "ES",
"status": "ok",
"period": { "from": "2020-01", "to": "2024-12", "label": "2020-2024" },
"groundMotion": {
"class": "severe_subsidence",
"worstClass": "severe_subsidence",
"vertical": {
"meanMmYear": -40.9, "maxSubsidenceMmYear": -40.9, "maxUpliftMmYear": 0,
"stdMmYear": 0.1, "accelerationMmYear2": -0.7, "rmseMm": 2.3
},
"eastWest": { "meanMmYear": -5.1, "stdMmYear": 0.1 },
"yearlyDisplacement": [
{ "year": 2020, "mm": -17.9 }, { "year": 2021, "mm": -57.2 }, { "year": 2022, "mm": -95.8 },
{ "year": 2023, "mm": -141.8 }, { "year": 2024, "mm": -179.8 }
],
"cellsWithData": 1, "cellsConsidered": 1, "coveragePct": 100,
"basis": "parcel", "cellSizeM": 100
},
"source": {
"name": "European Ground Motion Service (EGMS) L3 Ortho",
"license": "Copernicus data policy (Regulation (EU) No 1159/2013): free, commercial use allowed with attribution",
"attribution": "Contains modified Copernicus Land Monitoring Service information, European Ground Motion Service 2020-2024 (© European Union, Copernicus Land Monitoring Service, EEA)",
"resolution": "100 m"
},
"calculatedAt": "2026-10-01T08:13:58Z",
"provenance": "2"
},
"remainingSearches": 4320
}