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/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"Risposta reale
{
"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. 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/v1/parcels/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": {
"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. 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/v1/parcels/10194A00110004/terrain?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Risposta reale, abbreviata
{
"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. 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/v1/parcels/30024A16000286/ground-motion?country=ES" \
-H "X-API-Key: $CATASTROGPS_API_KEY"Risposta reale
{
"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
}