Verificare un immobile prima di acquistarlo
Dall'indirizzo dell'annuncio a ciò che dice il catasto e a ciò che si vede dal satellite: di quale finca si tratta, cosa contiene, se ricade in un'area protetta e se il terreno si muove. Ogni passaggio usa una particella diversa per mostrare un caso con dati; nel tuo flusso è lo stesso riferimento dall'inizio alla fine.
Paesi: ES
1. Dall'indirizzo alla finca
Un indirizzo in testo libero restituisce candidati ordinati per affidabilità (da 0 a 1) con il riferimento di 14 caratteri, la destinazione d'uso, le abitazioni e l'anno di costruzione. Da 0,75 in su coincidono numero civico e comune. Costa 1 unità solo se ci sono candidati.
curl -G "https://api.parcelgps.com/api/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"Risposta reale
{
"success": true,
"data": {
"consulta": {
"texto": "Avenida José Rodríguez de la Borbolla Camoyán 10, Dos Hermanas",
"calle": "Avenida José Rodríguez de la Borbolla Camoyán",
"numero": 10,
"municipio": "Dos Hermanas"
},
"candidatos": [
{
"refCatastral": "0745901TG4304N",
"pais": "ES",
"direccion": "AVENIDA JOSE RGUEZ BORBOLLA CAMOY 10",
"numero": 10,
"codigoPostal": "41704",
"municipio": "Dos Hermanas",
"provincia": "Sevilla",
"latitud": 37.31947088654626,
"longitud": -5.926788955974699,
"confianza": 0.93,
"coincideNumero": true,
"coincideMunicipio": true,
"enCopia": true,
"direccionCatastro": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"uso": "Residencial",
"viviendas": 346,
"anioConstruccion": 2023
},
{
"refCatastral": "0747201TG4304N",
"pais": "ES",
"direccion": "BULEVAR JOSE RODRIGUEZ DE LA BORBOLLA CAMOYAN 11",
"numero": 11,
"confianza": 0.55,
"coincideNumero": false,
"coincideMunicipio": true,
"enCopia": true
}
],
"attribution": "CartoCiudad (Instituto Geográfico Nacional) y Dirección General del Catastro"
}
}2. Cosa contiene: abitazioni, locali e pertinenze
Con il riferimento di 14 caratteri ottieni tutte le unità della finca con destinazione d'uso, superficie, piano, interno e coefficiente di partecipazione. Serve a verificare che superficie e destinazione d'uso dell'annuncio corrispondano al catasto. Costa 1 unità per ogni unità restituita.
curl "https://api.parcelgps.com/api/catastro/0745901TG4304N/units" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Risposta reale
HTTP/2 200
etag: "5ab6bd3d95f85dddba81818bcb0cb65e"
cache-control: private, max-age=21600
x-quota-remaining: 2893
{
"success": true,
"data": {
"refCatastral": "0745901TG4304N",
"direccion": "AV JOSE RGUEZ BORBOLLA CAMOY 10",
"codigoPostal": "41704",
"municipio": "DOS HERMANAS",
"provincia": "Sevilla",
"usoGeneral": "Residencial",
"superficieTotal": 32789,
"anioConstruccion": 2023,
"totalUnidades": 200,
"totalUnidadesFinca": 365,
"unidades": [
{
"refCatastral": "0745901TG4304N0002KH",
"escalera": "",
"planta": "01",
"puerta": "B",
"uso": "Residencial",
"superficie": 155,
"descripcion": "Planta 01, Pta. B - Residencial",
"participacion": 0.279543,
"anio": 2023,
"direccion": "AV JOSE RGUEZ BORBOLLA CAMOY 10 Pl:01 Pt:B"
},
{
"refCatastral": "0745901TG4304N0003LJ",
"escalera": "",
"planta": "01",
"puerta": "C",
"uso": "Residencial",
"superficie": 163,
"descripcion": "Planta 01, Pta. C - Residencial",
"participacion": 0.293879,
"anio": 2023,
"direccion": "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"
},
"searchesRemaining": -1
}3. Aree protette: Natura 2000 e parchi
Prima di acquistare un terreno agricolo conviene sapere se ricade in un'area protetta: limita ciò che si può costruire o piantare. /terrain interseca il contorno della particella con Natura 2000 e le aree protette nazionali (CDDA) e indica quale quota della particella vi ricade. Esempio reale: una particella interamente all'interno del Parco Nazionale di Monfragüe.
curl "https://api.parcelgps.com/api/catastro/10194A00110004/terrain?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Risposta reale, abbreviata
{
"success": true,
"data": {
"refcat": "10194A00110004",
"country": "ES",
"protected_areas": {
"status": "ok",
"intersects": true,
"inside": true,
"max_overlap_pct": 100,
"natura2000": [
{
"code": "ES0000014",
"name": "Monfragüe y las Dehesas del Entorno",
"type": "SPA",
"country": "ES",
"overlap_pct": 100
},
{
"code": "ES4320077",
"name": "Monfragüe",
"type": "SCI",
"country": "ES",
"overlap_pct": 100
}
],
"national": [
{
"code": "4820",
"name": "Monfragüe",
"designation": "National Park",
"country": "ES",
"overlap_pct": 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. Se il terreno si sta abbassando
/ground-motion fornisce la velocità verticale del terreno misurata dal radar Sentinel-1 (Copernicus EGMS, 2020-2024) sulla particella. Esempio reale: una particella a Murcia che si abbassa di 40,9 mm all'anno, classe severe_subsidence. Quando il satellite non ha riflettori (campi aperti, bosco, acqua) risponde status no_data invece di tirare a indovinare.
curl "https://api.parcelgps.com/api/catastro/30024A16000286/ground-motion?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Risposta reale
{
"success": true,
"data": {
"refcat": "30024A16000286",
"country": "ES",
"status": "ok",
"period": { "from": "2020-01", "to": "2024-12", "label": "2020-2024" },
"ground_motion": {
"class": "severe_subsidence",
"worst_class": "severe_subsidence",
"vertical": {
"mean_mm_year": -40.9, "max_subsidence_mm_year": -40.9, "max_uplift_mm_year": 0,
"std_mm_year": 0.1, "acceleration_mm_year2": -0.7, "rmse_mm": 2.3
},
"east_west": { "mean_mm_year": -5.1, "std_mm_year": 0.1 },
"yearly_displacement": [
{ "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 }
],
"cells_with_data": 1, "cells_considered": 1, "coverage_pct": 100,
"basis": "parcel", "cell_size_m": 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"
},
"calculated_at": "2026-10-01T06:14:34Z",
"provenance": "1"
}
}