API per dati catastali arricchiti su Zornade

Le API "Enriched Cadastral Parcels for Italy" disponibili gratuitamente su app.zornade.com consentono l'accesso programmatico a particelle catastali italiane con metadati territoriali, socio-economici e di rischio ambientale. Il servizio integra i dati ufficiali dell'Agenzia delle Entrate con indicatori derivati per supportare analisi immobiliari, due diligence e valutazioni territoriali scalabili.

Endpoints e parametri supportati

queryType	Parametri obbligatori	Output principale	Note operative
point	lat, lng	elenco FID delle particelle che contengono il punto	utile per geocoding inverso o click su mappa
bbox	bbox = [minLon, minLat, maxLon, maxLat]	FID entro il riquadro	limite area ≈ 0,06° per lato per contenere i tempi di risposta
fid	fid numerico	record completo con geometrie e attributi	richiede FID ottenuto da ricerche precedenti
list	params con filtri amministrativi (codice ISTAT, provincia, comune)	elenco FID filtrati	utile per elaborazioni massive

Tutte le richieste utilizzano il metodo POST verso https://app.zornade.com/functions/v1/get-parcels e richiedono un'intestazione Authorization Bearer con il token fornito al momento della registrazione gratuita su app.zornade.com.

Esempio di integrazione

curl --request POST       --url https://app.zornade.com/functions/v1/get-parcels       --header 'Authorization: Bearer <YOUR_API_TOKEN>'       --header 'Content-Type: application/json'       --data '{"queryType":"bbox","params":[7.75,45.35,7.751,45.351],"options":{"limit":3,"offset":0}}'

Risposta sintetica (campos ridotti per chiarezza):

{
  "success": true,
  "data": [
    {
      "id": {
        "fid": 48978812,
        "gml_id": "CadastralParcel.IT.AGE.PLA.A074_003200.1"
      },
      "location": {
        "municipality_name": "Agliè",
        "province_code": "TO",
        "region_name": "Piemonte"
      },
      "physical": {
        "footprint_sqm": 2185.07,
        "class": "agriculture"
      },
      "economic_indices": {
        "real_estate_potential_index": 44.17,
        "economic_resilience_index": 57.5
      },
      "risks": {
        "flood_risk": 0,
        "seismic_risk": 0.0459
      }
    }
  ],
  "meta": {
    "queryType": "bbox",
    "totalRows": 3,
    "duration": "152ms"
  }
}

Parole chiave del payload

Campo	Descrizione sintetica	Tipologia
id.fid	identificatore univoco della particella nel dataset	intero
location.geom	geometria WGS84 in formato GeoJSON (MultiPolygon)	oggetto
physical.*	indicatori fisici (superficie, quota, copertura suolo)	numerico/testuale
demographics.*	indicatori demografici stimati per la sezione censuaria	numerico
economic_indices.*	punteggi sintetici su potenziale immobiliare e resilienza	numerico
risks.*	livelli normalizzati di rischio idraulico, frane, sismico	numerico

Flusso operativo consigliato

Risoluzione geometrica: usare i queryType point o bbox per ottenere l'elenco dei FID nell'area di interesse, applicando filtri limit e offset per paginare risultati estesi.
Richiesta dettaglio: per ciascun FID prioritario, inviare una query fid e archiviare gli attributi necessari (geometria, indicatori, metadati).
Integrazione con sistemi GIS: convertire le geometrie GeoJSON in formati interni (es. WKT, shapefile) e incrociare gli indicatori con dataset locali.
Monitoraggio utilizzo: la dashboard di app.zornade.com permette di tenere traccia delle richieste effettuate e dei consumi.

Considerazioni su performance e qualità dati

Tempo di risposta medio: 120-250 ms per richieste puntuali; può salire oltre 600 ms per bounding box vicini al limite massimo.
Validazione automatica: coordinate fuori dal territorio nazionale producono errore INVALID_GEOMETRY con codice 422.
Aggiornamenti dataset: la pipeline è aggiornata periodicamente con base catastale ufficiale e fonti statistiche ISTAT; verificare la sezione "Changelog" su app.zornade.com per le date di refresh.
Persistenza: ogni record include il campo meta.timestamp utile per tracciare la data di estrazione nelle pipeline ETL.

Casi d'uso ricorrenti

Due diligence immobiliare: verifica consistente di proprietà con indicatori socio-economici e rischio naturale.
Location intelligence retail: incrocio con modelli proprietari per misurare domanda potenziale e saturazione competitiva.
Analisi ESG territoriale: monitoraggio parametri ambientali (flood, landslide, seismic risk) su portafogli immobiliari.
Aggiornamento basi cartografiche: arricchimento di sistemi GIS aziendali con geometrie catastali normalizzate.

Conformità e limitazioni

Utilizzare le API nel rispetto dei termini di servizio di Zornade e della normativa sul riuso dei dati catastali (Provvedimento Agenzia delle Entrate 05/05/2021).
Gestire le chiavi API in ambienti sicuri, evitando l'inclusione in client pubblici.
Verificare i vincoli privacy prima di combinare gli indicatori con dati personali o CRM.

API per dati catastali arricchiti: guida tecnica all'integrazione