L'API Particella Catastale è la soluzione avanzata per estrarre con precisione i dati di una specifica particella catastale, ottenendo la sua geometria completa e le impronte degli edifici con stato "REGISTERED". Grazie a logiche di ricerca flessibili e al calcolo intelligente delle adiacenze, semplifica l'integrazione di dati cartografici e immobiliari di dettaglio all'interno di qualsiasi software o gestionale.
Il servizio è pensato per digitalizzare e automatizzare la ricerca dei dati catastali e spaziali di dettaglio.
Attraverso questa API è possibile ottenere:
GET /particella
Per garantire la massima versatilità di sviluppo, è possibile effettuare la ricerca del foglio utilizzando esclusivamente uno dei seguenti tre metodi (a seconda dei dati di partenza a disposizione):
Il sistema restituirà un JSON contenente tutte le informazioni catastali, le geometrie spaziali, le impronte degli edifici "REGISTERED" e le eventuali particelle adiacenti calcolate nel raggio di ricerca.
https://catasto.openapi.it/particella?provincia=RM&comune=ROMA&sezione=C&foglio=872&particella=405&allegato=A0&lat=41.807269&lng=12.478288&indirizzo=VIA%20GIOVANNI%20GUARESCHI%2C%208%2C%20ROMA%20%28RM%29&search_radius=50GET /particella
Di seguito un esempio di risposta per i parametri indicati precedentemente:
{
"data": [
{
"identificativo": "H501C087200.405",
"comune": "ROMA",
"codice_catastale": "H501",
"provincia": "RM",
"sezione": "C",
"foglio": 872,
"particella": "405",
"allegato": null,
"superficie_m2": 1585.17,
"geometria": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
12.478568,
41.807199
],
[
12.4785164,
41.8072812
],
[
12.4784269,
41.8074133
],
[
12.4783695,
41.8075019
],
[
12.4781066,
41.807411
],
[
12.477954,
41.8073583
],
[
12.4779138,
41.8073444
],
[
12.4781105,
41.8070347
],
[
12.4781343,
41.8070433
],
[
12.4785029,
41.8071759
],
[
12.478568,
41.807199
]
]
]
]
},
"presenza_fabbricati": true,
"numero_fabbricati": 1,
"fabbricati": [
{
"type": "Polygon",
"coordinates": [
[
[
12.478480557,
41.807172205
],
[
12.478125911,
41.807043292
],
[
12.478025745,
41.807182028
],
[
12.478186704,
41.807245284
],
[
12.47814911,
41.807352219
],
[
12.478328966,
41.807414294
],
[
12.478480557,
41.807172205
]
]
]
}
]
}
],
"success": true,
"message": "",
"error": null
}
Questo un esempio di risposta nel caso in cui nella richiesta un parametro non è valido:
{
"data": {
"success": false,
"message": "only one search mode can be used: identifier (provincia, comune, foglio), coordinates (lat, lng) or indirizzo",,
"error": 600,
"data": null
}
Nell'eventualità che manchi un parametro obbligatorio, verrà restituito un messaggio con il codice errore rilevato:
{
"success": false,
"message": "missing search parameters: use the identifier (provincia, comune, foglio), the coordinates (lat, lng) or indirizzo",
"error": 600,
"data": null
}
Questo servizio si rivolge a diverse categorie di professionisti del settore. È lo strumento ideale per:
Il servizio fa parte dell'API Catasto.
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
L'API restituisce i dati catastali di base della particella richiesta, la sua geometria spaziale completa e le impronte fisiche degli edifici al suo interno che risultano con stato “REGISTERED”.
È possibile interrogare l'API scegliendo esclusivamente uno di questi tre metodi: per numero di particella (inserendo provincia, comune, foglio, particella ed eventuale sezione), per coordinate geografiche (latitudine e longitudine) o per indirizzo fisico.
Per cercare una specifica particella utilizzando i dati catastali, è obbligatorio inserire il codice provincia, il comune (nome o codice catastale es. H501), il foglio e la particella (cifre o singola lettera). Il parametro sezione è richiesto solo se il foglio specificato è presente in più sezioni dello stesso comune. Se la sezione manca in questo scenario, l'API restituirà un errore elencando le sezioni disponibili.
Il sistema utilizza una logica di prossimità intelligente: se il punto indicato non si trova all'interno di una particella mappata, l'API individua e restituisce automaticamente i dati della particella più vicina.
Fornendo un indirizzo completo, l'API mappa la posizione e restituisce la particella corrispondente. Tuttavia, poiché i numeri civici si trovano spesso su strada o agli ingressi, il risultato potrebbe restituire il lotto antistante l'edificio (cortile, strada privata) piuttosto che l'edificio stesso.
Sì, inserendo il parametro facoltativo “search_radius” (un valore intero compreso tra 50 e 200). L'API aggiungerà alla risposta tutte le particelle adiacenti comprese nel raggio impostato. Questo raggio viene misurato partendo dal punto esatto calcolato (in caso di ricerca per indirizzo/coordinate) o dal baricentro della particella (se cercata per numero di particella).
Il “search_radius” permette di espandere la ricerca alle particelle adiacenti impostando un raggio compreso tra 50 e 200 metri. Il raggio viene calcolato a partire dal punto esatto richiesto (nelle ricerche per coordinate o indirizzo) oppure dal baricentro della particella (nelle ricerche per dati catastali).
Per le ricerche spaziali, i parametri lat (latitudine) e lng (longitudine) devono essere espressi in gradi decimali (sistema WGS84) e riferirsi al territorio italiano. Qualora il punto esatto non ricada all'interno di una particella, l'API calcolerà e restituirà automaticamente la particella catastale più vicina.
Il parametro allegato (opzionale) permette di selezionare una parte specifica della mappa ufficiale (es. un allegato o uno sviluppo). È composto da 2 caratteri (es. A0 per l'allegato A, 0Z per lo sviluppo Z). Se lo ometti, l'API ti restituirà in automatico tutte le porzioni disponibili; se ne inserisci uno non valido, riceverai un messaggio di errore con l'elenco degli allegati effettivamente disponibili per quell'elemento.
L'ambiente Sandbox è studiato per consentire test di integrazione gratuiti senza consumare crediti. Indipendentemente dai parametri inseriti nella chiamata, la risposta simulata farà sempre riferimento ai dati della particella di ROMA (RM), sezione C, foglio 872, particella 405.
Questo servizio è lo strumento ideale per:
I dati vengono restituiti in tempo reale.
Il costo del servizio è a partire da € 0,08 su abbonamento o € 0,30 con addebito su ricarica.