Perché integrare i dati territoriali direttamente nei tuoi sistemi
Chi sviluppa software gestionali per la Pubblica Amministrazione, applicativi per professionisti dell’edilizia o portali per agenzie immobiliari conosce bene questo problema: i dati urbanistici e catastali sono spesso sparsi, difficili da consultare e complessi da tenere aggiornati.
Cercare manualmente un piano regolatore, verificare una norma di attuazione o recuperare i dati catastali di una particella richiede tempo e introduce il rischio di errori, soprattutto quando queste operazioni si ripetono decine o centinaia di volte al giorno all’interno di un flusso di lavoro digitale.
Il servizio API di UrbisMap nasce per eliminare questo collo di bottiglia: si tratta di un’infrastruttura di interrogazione dati che permette di richiamare, in tempo reale e in formato standard, le informazioni territoriali e urbanistiche direttamente all’interno del software che stai costruendo o utilizzando ogni giorno.
A chi si rivolge il servizio
Il servizio API di UrbisMap è pensato per un pubblico principalmente tecnico, come:
Professionisti e studi tecnici del settore edilizio e urbanistico
Agenzie immobiliari e portali immobiliari che vogliono mostrare dati aggiornati sui propri annunci
Software house che realizzano piattaforme verticali per il settore immobiliare o territoriale
Realtà che offrono ai propri clienti l’accesso a dati territoriali in tempo reale
Cosa puoi richiamare tramite le API
Una volta attivato il servizio, il pannello di documentazione tecnica mette a disposizione un elenco completo di funzioni interrogabili, organizzate per finalità:
Consumo quota mensile
Mostra il consumo della quota mensile API (chiamate utilizzate, chiamate rimanenti, limite disponibile) e lo storico delle chiamate recenti.
Ricerca territori per norme o slug
Individua Comuni e territori a partire da un nome o da uno slug testuale, restituendo il numero di piani disponibili per ciascuno.
Ricerca full-text su norme e articoli
Permette di cercare per rilevanza tra norme e articoli urbanistici, restituendo estratti testuali e link diretti al contenuto completo.
Piani che intersecano una particella
Individua la particella catastale corrispondente a un punto e restituisce l’elenco dei piani che la intersecano, con la percentuale di copertura.
Piani che contengono un punto
Dato un punto geografico (latitudine e longitudine), restituisce i piani urbanistici che lo includono, con le relative norme e articoli.
Norme di un piano
Restituisce l’elenco delle norme collegate a un piano, con link al dettaglio di ciascuna.
Geocoding indirizzo
Converte un indirizzo testuale in coordinate geografiche, fornendo fino a 5 risultati corrispondenti.
Dati catastali da coordinate
A partire da un punto geografico, restituisce i riferimenti catastali del Comune di appartenenza.
Dettaglio piano
Restituisce l’anagrafica completa di un piano urbanistico: titolo, territorio di riferimento, tipologia, stato e metadati.
Contenuti di un territorio
Elenca tutti i piani urbanistici associati a un territorio, con il conteggio di norme e articoli collegati.
Dettaglio articolo
Fornisce il testo completo di un singolo articolo, comprensivo di piano e norma di riferimento.
Modifiche del piano
Fornisce lo storico delle modifiche apportate a un piano urbanistico.
Dettaglio norma
Mostra le specifiche di una singola norma e dei suoi articoli collegati.
Articoli di un piano
Restituisce l’elenco paginato degli articoli associati a un piano.
Documenti del piano
Elenca i documenti e gli allegati associati a un piano urbanistico.
Gestione sicurezza e sandbox interattivo
All’interno della sezione Chiavi della piattaforma, l’utente può governare l’intero ciclo di vita dei token di autenticazione necessari per validare le richieste HTTP attraverso tre operazioni principali:
1. Elenca le proprie chiavi API: Restituisce l’elenco delle chiavi all’utente per monitorare le integrazioni attive.
2. Crea una chiave API: Genera istantaneamente una nuova stringa alfanumerica di autenticazione.
3. Revoca una chiave API: Consente di revocare in modo immediato e permanente un token compromesso o non più necessario, bloccando all’istante l’accesso ai dati.
Il modulo “Prova la richiesta”
Ogni singola sezione della documentazione presenta al suo interno un modulo sandbox “Prova la richiesta”.
Questo strumento permette di effettuare un test reale di chiamata verso i server di UrbisMap direttamente dall’interfaccia web, mostrando istantaneamente il funzionamento del servizio.
Onboarding e monitoraggio: la dashboard API del Geoportale
Per attivare il servizio è necessario registrarsi o accedere al proprio account sul Geoportale UrbisMap, scegliendo tra i livelli di profilo disponibili: Free, Premium o Premium PA.
Una volta completato l’acquisto del pacchetto di chiamate, all’interno della sezione “Profilo utente” del Geoportale comparirà il pulsante “Dashboard API” (visibile esclusivamente agli utenti che hanno attivato un pacchetto API).
Da questo pannello di controllo operativo è possibile monitorare in tempo reale:
– Le richieste a disposizione: mostra il contatore delle chiamate ancora disponibili rispetto al limite del pacchetto.
– La data di rinnovo dell’abbonamento: indica la scadenza del servizio (il rinnovo avviene in modalità automatica, ma è disattivabile dall’interfaccia utente in qualsiasi momento).
– Il registro delle ultime richieste effettuate: elenco dettagliato delle ultime chiamate effettuate dai tuoi applicativi, visualizzabile sotto forma di lista, istogramma o calendario.
– Infrastruttura documentale: collegamento ipertestuale diretto che reindirizza alla piattaforma esterna “Documentazione API” per la gestione tecnica.
Modelli di abbonamento e piani scalabili
L’infrastruttura tariffaria di UrbisMap è flessibile e si adatta a diversi volumi di traffico attraverso 4 abbonamenti standard e formule personalizzate:
- Tipologia piano
- Mensile base
- Mensile premium
- Semestrale base
- Semestrale premium
- Limite richieste
- 1000 richieste/mese
- 2500 richieste/mese
- 1000 richieste/mese
- 2500 richieste/mese
- Prezzo
- 250€ + VA
- 450€ + IVA
- Sconto del 10% sul prezzo complessivo
- Sconto del 10% sul prezzo complessivo
Personalizzazione del pacchetto: piani enterprise
Qualora le tue esigenze operative richiedano volumi superiori o soluzioni personalizzate, UrbisMap offre la possibilità di strutturare pacchetti su misura.
Contattaci tramite il form sottostante per richiedere la tua offerta personalizzata e definire accordi di servizio dedicati.
Richiedi la tua personalizzazione!
Il rinnovo dell’abbonamento è vincolante?
No. Il rinnovo avviene automaticamente per evitare interruzioni del servizio in ambiente di produzione, ma l’automatismo può essere disattivato in qualsiasi momento direttamente dal tuo profilo nel Geoportale.
Le chiavi API create possono essere revocate in autonomia?
Si, dalla sezione “Chiavi” della piattaforma di documentazione puoi creare o revocare in modo immediato e permanente qualsiasi chiave in qualsiasi momento, garantendo la massima sicurezza dei tuoi sistemi.
Azienda certificata ISO 9001 Certificato n°IT23-18103A
Azienda certificata ISO 27001 Certificato n°IT24-03301D
Progetto co-finanziato da
