Documentazione API
Tutto quello che serve per integrare 83M+ particelle catastali nelle tue applicazioni
Esplora per Prodotto
Guide, riferimenti API e tutorial organizzati per ogni prodotto Zornade
API REST
Integra dati catastali nelle tue applicazioni con API RESTful
Piattaforma Web
Esplora mappe catastali interattive senza scrivere codice
Dataset GIS
Scarica dataset territoriali in formati GIS standard
Plugin QGIS
Accedi ai dati catastali direttamente da QGIS
Servizi Custom
Soluzioni white-label e integrazioni enterprise
Help & Support
Risorse, tutorial e assistenza tecnica
Inizia in 3 Passi
Dalla registrazione alla prima chiamata API in meno di 5 minuti
Ottieni API Key
Registrati su app.zornade.com e ottieni la tua chiave gratuita
Fai la Prima Chiamata
Testa l'API con il nostro endpoint di esempio
Integra nell'App
Usa i nostri SDK o chiama direttamente l'API REST
Esplora la Documentazione
Guide complete, riferimenti API e best practice
Guida all'Uso
Tutorial passo-passo per iniziare rapidamente
Schema Dati
Struttura completa dei dati e layer disponibili
API Reference
Endpoint, parametri, response examples
Autenticazione
Setup API keys e gestione sicura credenziali
Rate Limits
Limiti, quote, best practice per performance
FAQ
Domande frequenti e troubleshooting
Guida all'Uso
Guida passo-passo per iniziare a utilizzare la nostra API di dati catastali italiani
Prerequisiti
- Un account Zornade attivo (gratuito)
- Un editor di codice o IDE
- Conoscenza base di REST API
- Un linguaggio di programmazione supportato (Python, JavaScript, PHP, ecc.)
Installazione
- Registrati su app.zornade.com se non hai già un account
- Naviga alla pagina della nostra API
- Scegli un piano di abbonamento
- Installa le librerie necessarie nel tuo ambiente di sviluppo
Configurazione Account
- Completa la verifica del tuo account Zornade
- Imposta un metodo di pagamento se necessario
- Conferma la tua iscrizione al piano scelto
- Verifica i limiti di rate del tuo piano
Ottenere le Chiavi API
- Vai alla dashboard Zornade
- Naviga alle tue API sottoscritte
- Trova la nostra API nella lista
- Copia la tua chiave API unica dalla sezione headers
Configurazione
- Memorizza la tua chiave API in un posto sicuro
- Configura le variabili d'ambiente se necessario
- Testa la connessione con una chiamata semplice
- Implementa la gestione degli errori appropriata
Iniziare a Usare l'API
- Scegli il tipo di query più adatto: point, bbox o fid
- Usa query geografiche per trovare particelle in un'area
- Usa query per FID per ottenere dati completi arricchiti
- Implementa la gestione degli errori e le validazioni
Note Importanti
Query per Punto Geografico
Trova particelle catastali usando coordinate geografiche specifiche
curl --request POST \
--url https://app.zornade.com/functions/v1/get-parcels \
--header 'Authorization: Bearer TUO_BEARER_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TUA_API_KEY' \
--data '{"type":"point","lat":45.3548155,"lng":7.7516446}'Risposta esempio:
{
"success": true,
"data": [48978812],
"meta": {
"queryType": "point",
"queryDuration": "177ms",
"totalRows": 1,
"validRows": 1
}
}Query per Area (Bounding Box)
Trova tutte le particelle in un'area rettangolare specifica
curl --request POST \
--url https://app.zornade.com/functions/v1/get-parcels \
--header 'Authorization: Bearer TUO_BEARER_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TUA_API_KEY' \
--data '{"type":"bbox","bbox":[7.7500,45.3540,7.7530,45.3560]}'Query per FID - Dati Completi Arricchiti
Ottieni tutti i dati dettagliati di una particella specifica usando il suo FID
curl --request POST \
--url https://app.zornade.com/functions/v1/get-parcels \
--header 'Authorization: Bearer TUO_BEARER_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TUA_API_KEY' \
--data '{"type":"fid","fid":"48978812"}'Risposta con dati completi arricchiti (abbreviata):
{
"success": true,
"data": {
"id": { "fid": 48978812, "gml_id": "CadastralParcel.IT.AGE..." },
"location": {
"municipality_name": "Agliè",
"region_name": "Piemonte",
"province_name": "Torino",
"geom": { "type": "MultiPolygon", "coordinates": [...] }
},
"physical": {
"class": "agriculture",
"footprint_sqm": 2185.07,
"elevation_min": 294.81
},
"demographics": {
"average_age": "40.0",
"average_family_size": "2.0"
},
"economic_indices": {
"real_estate_potential_index": "44.17",
"economic_resilience_index": "57.5"
},
"risks": {
"flood_risk": 0,
"seismic_risk": 0.0459
}
}
}Opzioni di Query Supportate
Il sistema supporta diverse modalità di ricerca per ottimizzare le tue query
Ricerca per Punto
{"queryType":"point","params":[longitude, latitude]}Ricerca per Bounding Box
{"queryType":"bbox","params":[minLon, minLat, maxLon, maxLat]}Ricerca per FID Specifico
{"fid": 48978812}Serve Aiuto?
Il nostro team è qui per supportarti
Guide & Tutorial
Esplora le nostre guide dettagliate e tutorial passo-passo
Vai al BlogDataset Gratuiti
Scarica dataset di esempio per testare la piattaforma
Vai ai DownloadPlugin QGIS
Integrazione nativa per professionisti GIS
Scarica PluginPronto per Iniziare?
Unisciti a migliaia di sviluppatori che già utilizzano la nostra API per costruire applicazioni straordinarie