Bologna, 19/12/2011 a cura di F. Malpensi

e-geocoding Guida ai Servizi Web Bologna, 19/12/2011 a cura di F. Malpensi

1. Sommario 1. Sommario... 2 2. Obiettivo della Soluzione... 3 3. Modifiche rispetto alle versioni precedenti... 4 3.1 Gestione Fonti Interpolazione... 4 3.2 Introduzione Id Univoci (UUID)... 4 3.3 Sistemi di riferimento... 4 3.4 Normalizzazione Massive... 4 E stato realizzato un nuovo servizio per normalizzare un intero set di indirizzi con una sola chiamata; il servizio è utile per normalizzazioni massive.quadro di riferimento... 4 4.1 Schema della soluzione... 5 4.2 Protocolli Standard... 6 4.2.1 SOAP... 6 4.2.2 WSDL... 6 4.2.3 XML, HTTP e HTTPS... 6 4.3 SOAP-Dispenser... 7 4.4 Strutture standard e naming convention... 8 4. Servizi per l Autenticazione... 9 4.4.1 GetHandle... 9 5. Servizi per la Gestione dei Sistemi di Riferimento... 10 5.1.1 Get_Tipo_Coord... 10 6. Servizi di Normalizzazione... 11 6.1 Gestione degli Identificativi... 11 6.2 Ricerca e Normalizzazione Indirizzi... 11 6.2.1 Norm_Indirizzo... 12 6.2.2 Norm_Indirizzo_Multi... 15 6.2.3 Norm_Indirizzo1 e Norm_Indirizzo2... 16 6.3 Ricerca e Normalizzazione Strade... 17 6.3.1 Norm_Stradario... 17 6.3.2 Gestione Descrizione Ufficiale... 18 6.3.3 Info_Entita_Stradario... 18 6.4 Ricerca e Normalizzazione Comuni... 20 6.4.1 Norm_Comune1... 20 6.4.2 Norm_Comune2... 21 6.5 Ricerca e Normalizzazione Province... 22 6.5.1 Norm_Provincia... 22 6.6 Ricerca e Normalizzazione Incroci... 23 6.6.1 Norm_Incrocio... 23 7. Servizi per la Restituzione di Geometrie... 25 6.6.2 Get_Str_Geom... 25 6.6.3 Get_Civ_Geom... 26 e-geocoding Guida ai Servizi Web Pag. 2 di 26

2. Obiettivo della Soluzione La normalizzazione è un processo che modifica un oggetto per renderlo più conforme a qualche criterio di regolarità. Nel caso degli indirizzi, i servizi esposti da e-geocoding confrontano l indirizzo da normalizzare con l elenco ufficiale dei toponimi e sulla base delle eventuali differenze riscontrate, trovano la migliore associazione tra il toponimo in input e quello ufficiale; dato che nella maggior parte dei casi gli indirizzi da normalizzare presentano lievi differenze rispetto a quelli presenti nel database di riferimento, i servizi in realtà possono restituire una o più corrispondenza, e per ciascuna di esse viene restituito il relativo grado di attendibilità. Oltre al toponimo, viene inoltre restituita la corrispondenza del numero civico. I servizi di e-geocoding, oltre a restituire il toponimo ufficiale, restituiscono anche alcune informazioni geografiche utili per la georeferenziazione dell indirizzo, come ad esempio le coordinate del numero civico e del rettangolo che contiene l arco stradale corrispondente. L infrastruttura necessaria per il sistema è implementata su un database Oracle. Nel DB sono presenti sia le tabelle che contengono tutti i dati necessari, sia tutto il codice PL/SQL necessario per accedere e gestire tali dati. I servizi vengono esposti in modalità webservice mediante il server SOAP-Dispenser, installato presso la regione e raggiungibile anche da extranet con protocollo https. Il presente documento si rivolge in particolare agli sviluppatori che intendano utilizzare i servizi esposti da e-geocoding mediante web-services. e-geocoding Guida ai Servizi Web Pag. 3 di 26

3. Modifiche rispetto alle versioni precedenti 3.1 Gestione Fonti Interpolazione Sono stati aggiunti due nuovi attributi per i numeri civici: la fonte da cui provengono e l informazione se il civico è stato ottenuto tramite interpolazione. Al momento l unica fonte disponibile è il database regionale (questi attributi sono stati creati per eventuali sviluppi futuri). E stata quindi creata un anagrafica delle fonti e ad ogni civico verrà associato l identificatore della fonte di provenienza. Nella procedura norm_indirizzo è stato aggiunto anche un filtro per poter effettuare la ricerca separatamente tra le fonti. I servizi di normalizzazione restituiscono un flag associato sempre alla riga del civico ( S civico interpolato, N civico non interpolato). 3.2 Introduzione Id Univoci (UUID) Sono stati standardizzati gli identificatori delle identità geografiche restituite dalle varie funzioni e contenute nei campi di tipo Entità. Questi identificatori chiamati UUID (Universal_Id) nel db topografico, saranno identificatori univoci di 36 caratteri. Gli identificatori interni del normalizzatore (es: Stradario_id) diventano di 32 caratteri e contengono degli Id Univoci la cui congruità nel tempo non è garantita. 3.3 Sistemi di riferimento La nuova versione offre la possibilità di fornire le coordinate in tutti i sistemi di riferimento regionali, mediante il parametro p_tipo_coord che nella versione precedente poteva assumere i valori UTMA e WGS84 e attualmente riconosce i seguenti valori: Nuovo Codice Vecchio Codice (deprecato) Sistema Tipo di Coordinata GBO GAUSS-BOAGA OVEST Planari in Metri GBE GAUSS-BOAGA EST Proiettati in metri UTMRER UTMA GBO con traslazione su N e E Planari in Metri RM40 Roma 40 Monte Mario Long,lat decimali ED50 EUROPEAN DATUM 1950 Long,lat decimali UTM32 ED50 / UTM 32N Planari in Metri UTM33 ED50/UTM 33N Planari in Metri ETRS89 ETRS 1989 Long,lat decimali ES32 ETRS89 / UTM Zone 32N Planari in Metri ES33 ETRS89 / UTM Zona 33N Planari in Metri WGS84 WGS84 WGS84 Long,lat decimali WU32 WGS84 / UTM Zone 32N Proiettati in metri WU33 WGS84 / UTM Zona 33N Proiettati in metri E stato anche reso disponibile un servizio che restituisce l elenco aggiornato di tali valori (di seguito il dettaglio). 3.4 Normalizzazione Massive E stato realizzato un nuovo servizio per normalizzare un intero set di indirizzi con una sola chiamata; il servizio è utile per normalizzazioni massive. e-geocoding Guida ai Servizi Web Pag. 4 di 26

Quadro di riferimento 4.1 Schema della soluzione Il presente schema presenta l architettura del sistema, evidenziando le principali tre componenti, e cioè: e-geocoding, che implementa i servizi Soap Dispenser, che espone i servizi secondo il protocollo SOAP Una applicazione Client che intenda utilizzare i servizi web e-geocoding Data Base Procedure PL/SQL Soap Dispenser SOAP over HTTP/HTTPS Applicazione Client Per ragioni di sicurezza, i servizi esposti in rete internet devono essere utilizzati mediante il protocollo HTTPS, che offre maggiore riservatezza sul canale di comunicazione. e-geocoding Guida ai Servizi Web Pag. 5 di 26

4.2 Protocolli Standard 4.2.1 SOAP I servizi di e-geocoding sono utilizzabili mediante chiamate sincrone standard secondo il protocollo SOAP. SOAP (Simple Object Access Protocol) è un protocollo leggero per lo scambio di messaggi tra componenti software, tipicamente nella forma di componentistica software. La parola object manifesta che l'uso del protocollo dovrebbe effettuarsi secondo il paradigma della programmazione orientata agli oggetti. L utilizzo di questo standard offre i seguenti vantaggi: esistono librerie standard per accedere a servizi SOAP per tutti i più diffusi linguaggi di programmazione (java, C#, Visual Basic, php,...) il protocollo prevede che le chiamate siano autodescritte, grazie ai WSDL 4.2.2 WSDL Il Web Services Description Language (WSDL) è un linguaggio formale in formato XML utilizzato per la creazione di "documenti" per la descrizione di Web Service. Mediante WSDL può essere, infatti, descritta l'interfaccia pubblica di un Web Service ovvero creata una descrizione, basata su XML, di come interagire con un determinato servizio: un "documento" WSDL contiene infatti, relativamente al Web Service descritto, informazioni su: cosa può essere utilizzato (le "operazioni" messe a disposizione dal servizio); come utilizzarlo (il protocollo di comunicazione da utilizzare per accedere al servizio, il formato dei messaggi accettati in input e restituiti in output dal servizio ed i dati correlati) ovvero i "vincoli" (bindings in inglese) del servizio; dove utilizzare il servizio (cosiddetto endpoint del servizio che solitamente corrisponde all'indirizzo - in formato URI - che rende disponibile il Web Service) Fornendo il WSDL, tutti i framework di sviluppo più diffusi consentono di generare automaticamente il codice sorgente necessario ad accedere ai corrispondenti servizi. Il WSDL dei servizi di e-geocoding è dinamicamente generato da SOAP-Dispenser, e può essere recuperato in qualsiasi momento accedendo a tale server. 4.2.3 XML, HTTP e HTTPS SOAP può operare su differenti protocolli di rete, ma HTTP è il più comunemente utilizzato e l'unico ad essere stato standardizzato dal W3C. SOAP si basa sul metalinguaggio XML e la sua struttura segue la configurazione Head-Body, analogamente ad HTML. Dato che HTTP è un protocollo che prevede uno scambio di messaggi in chiaro, anche se il dominio applicativo di e-geocoding non è particolarmente sensibile a problemi inerenti la sicurezza o la privacy, è possibile esporre i servizi utilizzando SOAP over HTTPS ; questa è la scelta che è stata fatta da Regione Emilia Romagna. HTTPS è un protocollo che integra l'interazione del protocollo HTTP attraverso un meccanismo di crittografia di tipo Transport Layer Security (SSL/TLS). Questa tecnica aumenta il livello di protezione contro attacchi del tipo man in the middle. e-geocoding Guida ai Servizi Web Pag. 6 di 26

4.3 SOAP-Dispenser Come precedentemente anticipato, i servizi di e-geocoding vengono esposti alle applicazioni client mediante il server SOAP-Dispenser. Questo software consente di: esporre come servizi web dati e stored procedures contenuti in un database generare automaticamente il corrispondente WSDL I servizi di e-geocoding della Regione Emilia Romagna, attualmente sono esposti al seguente URL: https://servizigis.regione.emilia-romagna.it/esoapdispenser/egeocoding Visitando con un web browser il suddetto link, si può: scaricare la versione aggiornata del file WSDL (clickando sul link Show Description wsdl ) o collegare il proprio framework di sviluppo a tale URL esaminare i servizi esposti e i relativi parametri di input/output La consolle accessibile al suddetto indirizzo presenta anche una parte utile all amministratore di sistema, che è protetta da password e non è di interesse per gli sviluppatori. e-geocoding Guida ai Servizi Web Pag. 7 di 26

4.4 Strutture standard e naming convention Tutti i servizi web esposti da SOAP-Dispenser, e quindi anche i servizi di e-geocoding, organizzano le chiamate/risposte secondo una struttura ed una naming convention standard: se ad esempio la funzione da chiamare si chiama ServiceABC, si avrà: ServiceABC ServiceABCInput ServiceABCOutput ServiceABCInputParams Parm1... ServiceABCOuputParams Parm1... InputFilter startrecord endrecord Array of ServiceABCOutputRecordset Column1... OutputInfo startrecord endrecord affectedrows Se il servizio ritorna solo dei dati scalari, invece che una tabella, la struttura non comprenderà l array di oggetti ServiceABCOutputRecordset. Ad esempio, il servizio Norm_indirizzo richiede in input un oggetto Norm_IndirizzoInput, che a sua volta si compone di Norm_indirizzoInputParams e InputFilter. Il servizio restituirà un oggetto Norm_IndirizzoOutput a sua volta composto di Norm_IndirizzoOutputParams, un array di tipo Norm_IndirizzoOutputRecordsetArray e OutputInfo. e-geocoding Guida ai Servizi Web Pag. 8 di 26

4. Servizi per l Autenticazione Per potere utilizzare i servizi di e-geocoding, l applicazione che intende richiamarli deve essere autenticata. Tale autenticazione avviene mediante una chiamata al servizio GetHandle, a cui deve essere fornito il nome identificativo dell applicazione utente e la corrispondente password. Dette utenze vengono univocamente assegnate dagli amministratori del sistema. 4.4.1 GetHandle E la funzione che identifica l utente tramite i parametri user e password e, in caso di riconoscimento avvenuto, restituisce una stringa contenente l handle di autenticazione che dovrà essere utilizzato per richiamare le procedure di ricerca. Nome Parametro Tipo Descrizione p_username VARCHAR2 nome utente p_ Userpassword VARCHAR2 Password OUTPUT: p_handle VARCHAR2 Handle di autenticazione da usare per le chiamate agli altri servizi Se l utente applicativo e la password sono esatte, il servizio di autenticazione restituisce l handle che dovrà essere successivamente utilizzato per le chiamate ai servizi di normalizzazione. In caso negativo verrà invece restituita una SOAP-Exception. NOTA: L handle ha una durata il cui valore è parametrizzato, quindi può essere impostato in base alle esigenze. Di default scade dopo un giorno, ma gli amministratori del sistema possono variarne la durata mediante il valore della costante di package K_Def_Cne_Ore_val nel Package Body KGEO_CNE. Il valore della variabile indica le ore di durata, di default è impostata a 24 ore (1 giorno). Si riporta a titolo di esempio uno spezzone di codice Microsoft Visual Basic che effettua la chiamata al servizio. Public Function GetHandle( Try ByVal Service As egeco.normalizzatore, _ ByVal susername As String, _ ByVal spassword As String) As String Dim hws_i As New egecows.gethandleinput Dim hws_ii As New egecows.gethandleinputparams hws_i.gethandleinputparams = hws_ii hws_ii.p_username = susername hws_ii.p_userpassword = spassword Dim hws_o As New egecows.gethandleoutput hws_o = Service.GetHandle(hws_i) Dim hws_op As egecows.gethandleoutputparams hws_op = hws_o.gethandleoutputparams Return hws_op.p_handle Catch ex1 As System.Web.Services.Protocols.SoapException ShowSoapException("GetHandle", ex1) Return Nothing Catch ex As Exception ShowException("GetHandle", ex) Return Nothing End Try End Function e-geocoding Guida ai Servizi Web Pag. 9 di 26

5. Servizi per la Gestione dei Sistemi di Riferimento Una volta identificata la corrispondenza tra il toponimo in input ed il toponimo presente nella banca dati di riferimento, i servizi di e-geocoding restituiscono un set di coordinate geografiche utili alla georeferenziazione, ossia alla rappresentazione su mappe del toponimo e delle informazioni che possono ad essere associate. Tipicamente vengono fornite le coordinate del rettangolo circoscritto e del centroide associato all arco strada; se il servizio ha riconosciuto anche il numero civico, possono essere fornite anche le coordinate del punto associato al civico (è possibile scegliere se restituire la posizione in cui il civico è posizionato all interno del corrispondente edificio o la proiezione del civico sull arco strada più vicino). Le coordinate restituite possono essere espresse secondo diversi sistemi di riferimento, cartesiani o geografici. Il sistema di riferimento di interesse viene specificato tra i parametri di input delle varie chiamate. I servizi di normalizzazione supportano tutti i più diffusi sistemi di riferimento diffusi in ambito locale. 5.1.1 Get_Tipo_Coord Questa funzione restituisce l elenco dei tipi di coordinate supportati. I Codici restituiti sono i valori da utilizzare per richiamare le funzioni del normalizzatore. La funzione restituirà un solo parametro contenente il codice di riuscita dell elaborazione Nome Parametro Tipo Descrizione INPUT: p_handle VARCHAR2 Handle di autenticazione OUTPUT: p_result_code NUMBER Codice restituito in OUTPUT, contenente un codice identificativo del successo della ricerca o del motivo dell insuccesso (0 la ricerca è andata a buon fine, > 0 la ricerca ha incontrato degli errori, I codici errore sono inseriti nella tabella GEOS_T_MESSAGGI) La funzione si chiama Get_Tipo_Coord e restituisce un rowset con i seguenti campi: Nome Campo Tipo Descrizione Tipo_coord_cod VARCHAR2(10) Codice del Tipo di coordinata (GBO, UTMRER,WGS84, ) E il codice da utilizzare come parametro nelle funzioni di ricerca Tipo_coord_des VARCHAR2(100) Descrizione de Tipo di coordinata e-geocoding Guida ai Servizi Web Pag. 10 di 26

6. Servizi di Normalizzazione Le funzioni disponibili sono la ricerca per indirizzo, stradario, comune, provincia, incrocio e coordinate singola strada o singolo civico. Le funzioni di ricerca sono accessibili solamente se si dispone dell handle_utente, il codice identificativo che viene restituito dalla funzione di autenticazione. 6.1 Gestione degli Identificativi Le principali funzioni esposte dai servizi di normalizzazione restituiscono gli identificativi associati agli oggetti presenti nel database di riferimento. Particolare rilevanza in questo ambito assumono le informazioni associate alle entità di origine: ENTITA_ID ENTITA_CIVICO_ID I servizi di normalizzazione fanno riferimento ad un database ottimizzato a questo scopo, che prevede ad esempio che uno stesso luogo possa essere identificato in vari modi: ad esempio, una strada potrebbe avere più nomi, in quanto espressa in più lingue oppure riferita come strada comunale o provinciale. Ne consegue, che il db di riferimento dei servizi di riferimento è basato su una struttura dati differente rispetto a quella primaria da cui deriva le informazioni. Nel caso dei servizi esposti dalla Regione Emilia Romagna, la fonte dati primaria è il data base topografico, e i campi ENTITA_ID e ENTITA_CIVICO_ID restituiscono gli identificati (UUID) delle relative entità di provenienza. 6.2 Ricerca e Normalizzazione Indirizzi La funzione principale che effettua la ricerca per indirizzo è la Norm_Indirizzo. La Norm_Indirizzo consente di normalizzare un solo toponimo per ciascuna chiamata e restituisce uno o più risultati, ordinati per grado di affidabilità. Per normalizzazioni massive esiste anche una versione in grado di elaborare più indirizzi con una sola chiamata, la Norm_Indirizzo_Multi; in questo caso il servizio restituirà per ciascun toponimo di input, solo la migliore corrispondenza trovata nel database di riferimento. Infine esistono altre due funzioni, ormai deprecate, Norm_Indirizzo1 e Norm_Indirizzo2. e-geocoding Guida ai Servizi Web Pag. 11 di 26

6.2.1 Norm_Indirizzo La Norm_Indirizzo consente di normalizzare un toponimo. Sono state implementate varie versioni della Norm_Indirizzo per poter effettuare le ricerche con parametri diversi; ovviamente se si dispone di informazioni disaggregate (via, nome strada, civico, comune,.. in colonne separate) si suggerisce di utilizzare la funzione con i parametri separati in quanto più efficiente. Un toponimo, come ad esempio Via Marconi 1 2 o Piazza Garibaldi 3 c si compone normalmente dei seguenti elementi: d.u.g. (denominazione urbana generica) esempio: (via, piazza) nome (Marconi, Garibaldi) civico (1,3) suffisso ( 2, A ) La Norm_Indirizzo è attualmente in grado di riconoscere ad esempio le seguenti situazioni: Nome Parametro Combinazione 1 Combinazione 2 Combinazione 2 Combinazione 3 Combinazione 3 p_toponimo Via Marconi Marconi Marconi Via Marconi, 1/2 Marconi, 1/2 p_civico ½ 1/2 1 Alla funzione devono inoltre essere forniti: oppure il nome del comune e nome/sigla della provincia il codice istat del comune o il codice nazionale o quello catastale Il parametro p_tipo_coord è utilizzato per specificar il sistema di riferimento a cui faranno riferimento le coordinate cartografiche restituite. Il parametro p_rif_geo_civ consente di specificare se si vuole che vengano restituite le coordinate del civico proiettate sull edificio o sull arco strada. Il parametro p_fonte_cod indica la fonte da utilizzare per la normalizzazione (attualmente i servizi di e-geocoding della Regione Emilia Romagna fanno esclusivamente riferimento al database topografico regionale, per cui questo parametro non è significativo). Parametri in ingresso/uscita: Nome Parametro Tipo Descrizione INPUT: p_toponimo VARCHAR2 nome della strada. La stringa non deve contenere un numero civico p_civico VARCHAR2 eventuale numero del civico della strada (incluso di eventuale suffisso) p_ comune VARCHAR2 eventuale nome del comune p_ provincia VARCHAR2 eventuale nome o alla sigla della provincia p_cod_istat VARCHAR2 eventuale Codice ISTAT del Comune p_cod_nazionale VARCHAR2 eventuale Codice nazionale del comune (agenzia del territorio) p_cod_catastale VARCHAR2 eventuale Codice catastale del comune (agenzia del territorio) p_tipo_coord VARCHAR2 Tipo di coordinata che si vuole venga restituita (UTMRER,WGS84, ) p_rif_geo_civ VARCHAR2 Tipo di coordinata del civico che si vuole venga restituita (ECIV,PCIV, ) p_fonte_cod VARCHAR2 Tipo della fonte dei dati che si vuole utilizzare ( ALL" è il default e utilizza tutti i dati di tutte le Fonti) p_handle VARCHAR2 Handle di autenticazione OUTPUT: p_result_code NUMBER Codice restituito in OUTPUT, contenente un numero identificativo del successo della ricerca o del motivo dell insuccesso (0 la ricerca è andata a buon fine, > 0 la ricerca ha incontrato degli errori, I codici errore sono inseriti nella tabella GEOS_T_MESSAGGI) e-geocoding Guida ai Servizi Web Pag. 12 di 26

Il rowset restituito dalla Norm_Indirizzo contiene i seguenti campi: Nome Campo Tipo Descrizione STRADARIO_ID VARCHAR2(32) Codice dell'indirizzo ENTITA_ID VARCHAR2(36) Codice dell'entità dell Indirizzo(Una strada può avere più toponimi di definizione) DUG VARCHAR2(50) Descrizione denominazione urbanistica generica (Via, Piazza,.) DENOMINAZIONE VARCHAR2(200) Denominazione dell'area di circolazione (nome della strada) TIPO_STRADA VARCHAR2 (10) Codice di identificazione del tipo di strada COMUNE VARCHAR2(200) Comune di appartenenza della strada PROVINCIA VARCHAR2(200) Provincia di appartenenza della strada REGIONE VARCHAR2(200) Regione di appartenenza della strada TIPO_COORD VARCHAR2 (10) Codice di identificazione del tipo di coordinata richiesta (UTMRER,WGS84, ) MIN_X NUMBER Coordinata X MIN della strada, del tipo richiesto MIN_Y NUMBER Coordinata Y MIN della strada, del tipo richiesto MAX_X NUMBER Coordinata X MAX della strada, del tipo richiesto MAX_Y NUMBER Coordinata Y MAX della strada, del tipo richiesto CENTR_X NUMBER Coordinata X del centroide della strada CENTR _Y NUMBER Coordinata Y del centroide della strada FONTE VARCHAR2(100) Descrizione della fonte di provenienza del dato INTERPOLAZIONE VARCHAR2(1) Indica se i dati relativi al civico sono frutto di un interpolazione ( S, N ) CIVICO_ID VARCHAR2(32) Codice del numero civico. Se il civico non viene trovato, viene restituito NULL ENTITA_CIVICO_ID VARCHAR2(36) Codice dell entita numero civico. Se il civico non viene trovato, viene restituito NULL NUM_CIVICO NUMBER(10) Numero civico. Se il civico non viene trovato, viene restituito NULL SUFFISSO_CIVICO VARCHAR2(30) Suffisso. Se il suffisso non viene trovato, viene restituito NULL DESCRIZIONE_CIVICO VARCHAR2(200) Eventuale descrizione di un civico. Se il suffisso non viene trovato, viene restituito NULL CIVICO_ARCO_ID NUMBER Codice dell arco del numero civico. Se il civico non viene trovato, viene restituito NULL RIF_GEO_CIV VARCHAR2 (10) Codice di identificazione del tipo di coordinata del civico (ECIV,PCIV, ) CIVICO_X NUMBER Coordinata X del civico. Se il civico non viene trovato, viene restituito NULL CIVICO_Y NUMBER Coordinata Y del civico. Se il civico non viene trovato, viene restituito NULL GR_AFFIDABILITA NUMBER(3) Grado di affidabilità della riga restituita sulla base del toponimo (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. GR_AFFIDABILITA_CIV NUMBER(3) Grado di affidabilità del numero civico. 0 indica la massima affidabilità; 1 non è stato trovato il suffisso, se passato come parametro, altrimenti non è stato trovato il civico; 2 non è stato trovato né il civico né il suffisso. NUMERO_RIGHE NUMBER(3) Totale delle righe restituite NUMERO_RIGA NUMBER(3) Numero della riga restituita ordinata per gr_affidabilita Il rowset conterrà gli indirizzi ottenuti tramite gli algoritmi di ricerca. e-geocoding Guida ai Servizi Web Pag. 13 di 26

Se l'indirizzo viene identificato univocamente, l array conterrà solo l'indirizzo individuato. Altrimenti verranno restituiti più indirizzi, con associati il grado di affidabilità del risultato (0 = via identificata con certezza, > 0 incerto). Le righe ritornate sono ordinate per livelli di affidabilità decrescenti. Il grado di affidabilità non è direttamente influenzato dal numero civico: per sapere se il civico è stato identificato o no si deve guardare il campo CIVICO_ID, che sarà a NULL in caso in cui la ricerca fallisca e verificare il grado di affidabilità del civico. Il suffisso viene individuato tramite una funzione apposita, separatamente quindi dal civico, in modo da poter identificare civici anche se hanno il suffisso sbagliato. Nel caso di ricerca di un civico di una località, se non viene trovato, verrà riportato (se inserito in tabella dalla procedura di aggiornamento della GEO_T_CIVICI) il civico numero 0, che rappresenta il punto centrale della località. Nota: Nelle ricerche effettuate dalla norm_indirizzo verranno sempre esclusi gli oggetti di tipo Percorsi Calibrati. e-geocoding Guida ai Servizi Web Pag. 14 di 26

6.2.2 Norm_Indirizzo_Multi La Norm_Indirizzo_Multi è ottimizzata per effettuare normalizzazioni massive. A tal fine, in input può essere passato un intero set di toponimi, che devono essere compattati in un unica stringa opportunamente formattata per indicare i separatori di colonna e di riga. Si suggerisce di usare set di qualche decina di toponimi. La stringa contenente l elenco di indirizzi deve essere inserita nel parametro P_Indirizzi. Per ciascun indirizzo devono essere considerati tutti i parametri della norm_indirizzo, anche se non valorizzati: P_Toponimo P_Civico P_Comune P_Provincia P_Cod_Istat P_Cod_Nazionale P_Cod_Catastale P_Tipo_Coord P_Rif_Geo_Civ P_Fonte_Cod Le singole informazioni dovranno essere suddivise da un carattere di separazione predeterminato, da indicare nel parametro P_Sep_Param_Char. Ogni indirizzo a sua volta dovrà essere separato da un carattere di separazione, da indicare nel parametro P_Sep_Ind_Char. I due caratteri devono essere differenti. Nome Parametro Tipo Descrizione INPUT: p_indirizzi CLOB Elenco toponimi p_sep_ind_char VARCHAR2 Separatore degli indirizzi P_sep_param_char VARCHAR2 Separatore dei parametri p_handle VARCHAR2 Handle di autenticazione OUTPUT: p_result_code NUMBER Codice restituito in OUTPUT, contenente un codice identificativo del successo della ricerca o del motivo dell insuccesso (0 la ricerca è andata a buon fine, > 0 la ricerca ha incontrato degli errori, I codici errore sono inseriti nella tabella GEOS_T_MESSAGGI) La Norm_Indirizzo_Multi restituisce un rowset, molto simile a quello della Norm_Indirizzo; mentre per la Norm_Indirizzo viene restituito il rowset associato a tutte le migliori corrispondenze del toponimo in input, il rowset della Norm_Indirizzo_Multi contiene una sola corrispondenza associata al corrispondente toponimo di input e l eventuale errore associato: Nome Campo Tipo Descrizione STRADARIO_ID VARCHAR2(32) Codice dell'indirizzo ENTITA_ID VARCHAR2(36) Codice dell'entità dell Indirizzo(Una strada può avere più toponimi di definizione) DUG VARCHAR2(50) Descrizione denominazione urbanistica generica (Via, Piazza,.) DENOMINAZIONE VARCHAR2(200) Denominazione dell'area di circolazione (nome della strada) TIPO_STRADA VARCHAR2 (10) Codice di identificazione del tipo di strada COMUNE VARCHAR2(200) Comune di appartenenza della strada PROVINCIA VARCHAR2(200) Provincia di appartenenza della strada e-geocoding Guida ai Servizi Web Pag. 15 di 26

REGIONE VARCHAR2(200) Regione di appartenenza della strada TIPO_COORD VARCHAR2 (10) Codice di identificazione del tipo di coordinata richiesta (UTMRER,WGS84, ) MIN_X NUMBER Coordinata X MIN della strada, del tipo richiesto MIN_Y NUMBER Coordinata Y MIN della strada, del tipo richiesto MAX_X NUMBER Coordinata X MAX della strada, del tipo richiesto MAX_Y NUMBER Coordinata Y MAX della strada, del tipo richiesto CENTR_X NUMBER Coordinata X del centroide della strada CENTR _Y NUMBER Coordinata Y del centroide della strada FONTE VARCHAR2(100) Descrizione della fonte di provenienza del dato INTERPOLAZIONE VARCHAR2(1) Indica se i dati relativi al civico sono frutto di un interpolazione ( S, N ) CIVICO_ID VARCHAR2(32) Codice del numero civico. Se il civico non viene trovato, viene restituito NULL ENTITA_CIVICO_ID VARCHAR2(36) Codice dell entita numero civico. Se il civico non viene trovato, viene restituito NULL NUM_CIVICO NUMBER(10) Numero civico. Se il civico non viene trovato, viene restituito NULL SUFFISSO_CIVICO VARCHAR2(30) Suffisso. Se il suffisso non viene trovato, viene restituito NULL DESCRIZIONE_CIVICO VARCHAR2(200) Eventuale descrizione di un civico. Se il suffisso non viene trovato, viene restituito NULL CIVICO_ARCO_ID NUMBER Codice dell arco del numero civico. Se il civico non viene trovato, viene restituito NULL RIF_GEO_CIV VARCHAR2 (10) Codice di identificazione del tipo di coordinata del civico (ECIV,PCIV, ) CIVICO_X NUMBER Coordinata X del civico. Se il civico non viene trovato, viene restituito NULL CIVICO_Y NUMBER Coordinata Y del civico. Se il civico non viene trovato, viene restituito NULL GR_AFFIDABILITA NUMBER(3) Grado di affidabilità della riga restituita sulla base del toponimo (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. GR_AFFIDABILITA_CIV NUMBER(3) Grado di affidabilità del numero civico. 0 indica la massima affidabilità; 1 non è stato trovato il suffisso, se passato come parametro, altrimenti non è stato trovato il civico; 2 non è stato trovato né il civico né il suffisso. NUMERO_RIGHE NUMBER(3) Totale delle righe restituite NUMERO_RIGA NUMBER(3) Numero della riga restituita ordinata per gr_affidabilita RESULT_CODE NUMBER E il codice dell errore restituito da ogni ricerca (l anagrafica di riferimento è la GEOS_T_MESSAGGI) 6.2.3 Norm_Indirizzo1 e Norm_Indirizzo2 Queste funzioni sono state mantenute per compatibilità con le versioni precedenti, ma risultano deprecate. e-geocoding Guida ai Servizi Web Pag. 16 di 26

6.3 Ricerca e Normalizzazione Strade E utilizzabile per normalizzare oggetti come i percorsi Calibrati, le strade extraurbane e le estese amministrative. Si tratta di entità che non hanno civici associati e la ricerca avviene quindi solo sul nome. 6.3.1 Norm_Stradario Questa funzione opera in modo similare alla norm_indirizzo, ma non effettua le ricerche dei civici, individua quindi solo il toponimo richiesto. Parametri in ingresso/uscita: Nome Parametro Tipo Descrizione INPUT: p_toponimo VARCHAR2 nome della strada. La stringa non deve contenere un numero civico p_ comune VARCHAR2 eventuale nome del comune p_ provincia VARCHAR2 eventuale nome o alla sigla della provincia p_cod_istat VARCHAR2 eventuale Codice ISTAT del Comune p_cod_ nazionale VARCHAR2 eventuale Codice nazionale del comune (agenzia del territorio) p_cod_ catastale VARCHAR2 eventuale Codice catastale del comune (agenzia del territorio) p_tipo_coord VARCHAR2 Tipo di coordinata che si vuole venga restituita (UTMRER,WGS84, ) p_rif_geo_civ VARCHAR2 Tipo di coordinata del civico che si vuole venga restituita (ECIV,PCIV, ) p_fonte_cod VARCHAR2 Tipo della fonte dei dati che si vuole utilizzare ( ALL" è il default e utilizza tutti i dati di tutte le Fonti) p_tipo_strada Eventuale Tipo di strada che si vuole venga restituito p_descrizione_uff S o N se si vuole che venga restituita la descrizione ufficiale legata al toponimo ricercato o no (default = N ) p_handle VARCHAR2 Handle di autenticazione OUTPUT: p_result_code NUMBER Codice restituito in OUTPUT, contenente un numero identificativo del successo della ricerca o del motivo dell insuccesso (0 la ricerca è andata a buon fine, > 0 la ricerca ha incontrato degli errori, I codici errore sono inseriti nella tabella GEOS_T_MESSAGGI) In più è stato aggiunto il p_tipo_strada e il p_descrizione_uff. Tramite il primo, se impostato, è possibile filtrare per un tipo di strada specifico. Sarà quindi possibile effettuare ricerche nello stradario esclusivamente tra i Percorsi Calibrati, o tra le località, o tra le estese amministrative, ecc... Il p_descriz_uff consente di richiedere che la ricerca avvenga solo per le descrizioni ufficiali dei toponimi. Nota: I valori del tipo strada sono definiti nella tabella Geo_t_tipi_strada, campo COD_TIPO_STRADA. Al momento i valori censiti sono: Cod_Tipo_strada Des_Tipo_strada AA Autostrada EE Strada Europea LC Località NN strada generica PR Strada Privata RC Raccordo SC Strada Comunale e-geocoding Guida ai Servizi Web Pag. 17 di 26

SD SE SF SI SM SP SR SS SV TG Strada Demaniale Strada Escursionistica Strada Forestale Strada Interpoderale Strada Militare Strada Provinciale Strada Regionale Strada Statale Strada Vicinale ad uso pubblico Tangenziale Il record restituito è simile a quello della norm_indirizzo, sono stati esclusi i campi relativi al civico. Nome Campo Tipo Descrizione STRADARIO_ID VARCHAR2(32) Codice dell'indirizzo ENTITA_ID VARCHAR2(36) Codice dell'entità dell Indirizzo(Una strada può avere più toponimi di definizione) DUG VARCHAR2(50) Descrizione denominazione urbanistica generica (Via, Piazza,.) DENOMINAZIONE VARCHAR2(200) Denominazione dell'area di circolazione (nome della strada) TIPO_STRADA VARCHAR2 (10) Codice di identificazione del tipo di strada COMUNE VARCHAR2(200) Comune di appartenenza della strada PROVINCIA VARCHAR2(200) Provincia di appartenenza della strada REGIONE VARCHAR2(200) Regione di appartenenza della strada TIPO_COORD VARCHAR2 (10) Codice di identificazione del tipo di coordinata richiesta (UTMRER,WGS84, ) DESCRIZ_UFF VARCHAR2 (1) Definisce se la descrizione restituita è ufficiale o no (valori 'S','N') MIN_X NUMBER Coordinata X MIN della strada, del tipo richiesto MIN_Y NUMBER Coordinata Y MIN della strada, del tipo richiesto MAX_X NUMBER Coordinata X MAX della strada, del tipo richiesto MAX_Y NUMBER Coordinata Y MAX della strada, del tipo richiesto CENTR_X NUMBER Coordinata X del centroide della strada CENTR _Y NUMBER Coordinata Y del centroide della strada GR_AFFIDABILITA NUMBER(3) Grado di affidabilità della riga restituita sulla base del toponimo (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. NUMERO_RIGHE NUMBER(3) Totale delle righe restituite NUMERO_RIGA NUMBER(3) Numero della riga restituita ordinata per gr_affidabilita 6.3.2 Gestione Descrizione Ufficiale La descrizione ufficiale è gestita per i tipi estese amministrative e Percorsi Calibrati. In fase di ricerca verrà restituito il flag Descriz_uff con valori 'S' nel caso sia stata restiuita la descrizione ufficiale, 'N' descrizione non ufficiale. 6.3.3 Info_Entita_Stradario Questa funzione restituirà i dati della descrizione ufficiale relativa ad un codice entità. e-geocoding Guida ai Servizi Web Pag. 18 di 26

Il Parametro di input sarà quindi il codice entità: p_entita_id IN VARCHAR2; Il record restituito è uguale a quello della norm_stradario. e-geocoding Guida ai Servizi Web Pag. 19 di 26

6.4 Ricerca e Normalizzazione Comuni Le funzione che effettuano la ricerca di un comune sono le Norm_Comune1 e Norm_Comune2. Sono state implementate due versioni della Norm_Comune, per poter effettuare le ricerche con parametri diversi; ovviamente se si dispone di informazioni disaggregate (Cap, Comune e Provincia in colonne separate) si suggerisce di utilizzare la funzione con i parametri separati in quanto più efficiente. 6.4.1 Norm_Comune1 La Norm_Comune1 consente di effettuare la ricerca del comune passando un'unica stringa che può contenere un Cap, la descrizione del comune e la provincia (sigla o descrizione). La descrizione del comune e la provincia sono obbligatori e devono essere scritti in sequenza (prima il comune, poi la provincia). Nome Parametro Tipo Descrizione p_toponimo VARCHAR2 nome della strada. La stringa potrà contenere eventualmente un cap (5 cifre), la descrizione del comune, eventualmente la sigla o la descrizione della provincia p_handle VARCHAR2 Handle di autenticazione Restituisce un cursore contenente i comuni con denominazioni più simili, ottenuti tramite gli algoritmi di ricerca. Se il comune viene identificato univocamente l array conterrà solo il comune individuato. Altrimenti verranno restituiti più comuni associati ad un grado di affidabilità del risultato (0 l'indirizzo è esatto, > 0 differisce dai parametri di input). Tutti i parametri passati in input verranno aggiunti come filtro per l'estrazione. L array restituito contiene i seguenti campi: Nome Campo Tipo Descrizione COMUNE_ID NUMBER(22) Codice del Comune TOPONIMO VARCHAR2(200) Descrizione (toponimo) del Comune CAP VARCHAR2(5) Codice di avviamento postale COD_ISTAT VARCHAR2(6) Codice ISTAT del Comune COD_NAZIONALE VARCHAR2(4) Codice dell'agenzia per il territorio del Comune COD_CAT VARCHAR2(4) Codice catastale del comune (agenzia del territorio) FLG_CESSATO VARCHAR2(1) Indica se il comune esiste come entità territoriale GR_AFFIDABILITA NUMBER(3) Grado di affidabilità della riga restituita sulla base del toponimo (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. NUMERO_RIGHE NUMBER(3) Totale delle righe restituite NUMERO_RIGA NUMBER(3) Numero della riga restituita ordinata per gr_affidabilita e-geocoding Guida ai Servizi Web Pag. 20 di 26

6.4.2 Norm_Comune2 La Norm_Comune2 richiede la descrizione del comune, il cap e la provincia come parametri distinti, in più consente la ricerca per codice istat, nazionale o catastale. Se si effettua la ricerca per nome del comune, sarà obbligatorio anche il parametro provincia. Parametri in ingresso: Nome Parametro Tipo Descrizione p_toponimo VARCHAR2 nome del comune. La stringa dovrà contenere solo la descrizione del comune. p_cap VARCHAR2 eventuale Codice di avviamento postale p_ provincia VARCHAR2 eventuale nome o alla sigla della provincia p_cod_istat VARCHAR2 eventuale Codice ISTAT del Comune p_cod_ nazionale VARCHAR2 eventuale Codice nazionale del comune (agenzia del territorio) p_cod_ catastale VARCHAR2 eventuale Codice catastale del comune (agenzia del territorio) p_handle VARCHAR2 Handle di autenticazione Restituisce un cursore contenente i comuni con denominazioni più simili, ottenuti tramite gli algoritmi di ricerca. Se il comune viene identificato univocamente l array conterrà solo il comune individuato. Altrimenti verranno restituiti più comuni associati ad un grado di affidabilità del risultato (0 l'indirizzo è esatto, > 0 differisce dai parametri di input). Tutti i parametri passati in input verranno aggiunti come filtro per l'estrazione. L array restituito contiene i seguenti campi: Nome Campo Tipo Descrizione COMUNE_ID NUMBER(22) Codice del Comune TOPONIMO VARCHAR2(200) Descrizione (toponimo) del Comune CAP VARCHAR2(5) Codice di avviamento postale COD_ISTAT VARCHAR2(6) Codice ISTAT del Comune COD_NAZIONALE VARCHAR2(4) Codice dell'agenzia per il territorio del Comune COD_CAT VARCHAR2(4) Codice catastale del comune (agenzia del territorio) FLG_CESSATO VARCHAR2(1) Indica se il comune esiste come entità territoriale GR_AFFIDABILITA NUMBER(3) Grado di affidabilità della riga restituita sulla base del toponimo (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. NUMERO_RIGHE NUMBER(3) Totale delle righe restituite NUMERO_RIGA NUMBER(3) Numero della riga restituita ordinata per gr_affidabilita e-geocoding Guida ai Servizi Web Pag. 21 di 26

6.5 Ricerca e Normalizzazione Province La funzione che effettua la ricerca di una Provincia è la Norm_Provincia. 6.5.1 Norm_Provincia La funzione Norm_Provincia consente la ricerca in base alla descrizione o alla sigla della provincia e in base al codice istat o nazionale. Parametri in ingresso: Nome Parametro Tipo Descrizione INPUT: p_ provincia VARCHAR2 nome o sigla della provincia p_cod_istat VARCHAR2 eventuale Codice ISTAT della provincia p_cod_nazionale VARCHAR2 eventuale Codice nazionale della provincia (agenzia del territorio) p_handle VARCHAR2 Handle di autenticazione Restituisce un cursore contenente le province più simili ottenute tramite un algoritmo di ricerca. Se la provincia viene identificata univocamente il cursore conterrà solo la provincia individuata. Altrimenti verranno restituite più province associate ad un grado di affidabilità del risultato (0 l'indirizzo è esatto, > 0 differisce dai parametri di input). Tutti i parametri passati in input verranno aggiunti come filtro per l'estrazione. Restituisce un array con i seguenti campi: Nome Campo Tipo Descrizione PROVINCIA _ID NUMBER(22) Codice della Provincia TOPONIMO VARCHAR2(200) Descrizione (toponimo) della Provincia SIGLA VARCHAR2(10) Sigla targa automobilistica della Provincia COD_ISTAT VARCHAR2(6) Codice ISTAT della provincia COD_NAZIONALE VARCHAR2(4) Codice dell'agenzia per il territorio della provincia GR_AFFIDABILITA NUMBER(3) Grado di affidabilità della riga restituita sulla base del toponimo (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. NUMERO_RIGHE NUMBER(3) Totale delle righe restituite NUMERO_RIGA NUMBER(3) Numero della riga restituita ordinata per gr_affidabilita e-geocoding Guida ai Servizi Web Pag. 22 di 26

6.6 Ricerca e Normalizzazione Incroci La funzioni che effettua la ricerca di un incrocio fra due strade è la Norm_Incrocio. 6.6.1 Norm_Incrocio La Norm_Incrocio richiede il toponimo, la provincia e il comune delle due strade di cui si vuole verificare un eventuale incrocio. Parametri in ingresso: Nome Parametro Tipo Descrizione INPUT: p_toponimo1 VARCHAR2 nome della strada della prima strada p_ comune1 VARCHAR2 nome del comune della prima strada p_ provincia1 VARCHAR2 nome o sigla della provincia della prima strada p_toponimo2 VARCHAR2 nome della strada della seconda strada p_ comune2 VARCHAR2 nome del comune della seconda strada p_ provincia2 VARCHAR2 nome o sigla della provincia della seconda strada p_tipo_coord VARCHAR2 Tipo di coordinata che si vuole venga restituita (UTMRER,WGS84, ) p_handle VARCHAR2 Handle di autenticazione OUTPUT: p_result_code NUMBER Codice restituito in OUTPUT, contenente un codice identificativo del successo della ricerca o del motivo dell insuccesso (0 la ricerca è andata a buon fine, > 0 la ricerca ha incontrato degli errori, I codici errore sono inseriti nella tabella GEOS_T_MESSAGGI) La Norm_Incrocio restituisce un rowset con i seguenti campi Nome Campo Tipo Descrizione ENTITA_ID1 VARCHAR2(36) Codice dell'entità dell Indirizzo(Una strada può avere più toponimi di definizione) della prima strada DUG1 VARCHAR2(50) Descrizione denominazione urbanistica generica (Via, Piazza,.) della prima strada DENOMINAZIONE1 VARCHAR2(200) Denominazione dell'area di circolazione (nome della strada) della prima strada COMUNE1 VARCHAR2(200) Comune di appartenenza della prima strada PROVINCIA1 VARCHAR2(200) Provincia di appartenenza della prima strada REGIONE1 VARCHAR2(200) Regione di appartenenza della prima strada GR_AFFIDABILITA1 NUMBER(3) Grado di affidabilità della riga restituita sulla base del toponimo della prima strada (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. ENTITA_ID2 VARCHAR2(36) Codice dell'entità dell Indirizzo(Una strada può avere più toponimi di definizione) della seconda strada DUG2 VARCHAR2(50) Descrizione denominazione urbanistica generica (Via, Piazza,.) della seconda strada DENOMINAZIONE2 VARCHAR2(200) Denominazione dell'area di circolazione (nome della strada) della seconda strada COMUNE2 VARCHAR2(200) Comune di appartenenza della seconda strada PROVINCIA2 VARCHAR2(200) Provincia di appartenenza della seconda strada REGIONE2 VARCHAR2(200) Regione di appartenenza della seconda strada GR_AFFIDABILITA2 NUMBER(3) Grado di affidabilità della riga restituita sulla base del e-geocoding Guida ai Servizi Web Pag. 23 di 26

toponimo della seconda strada (escluso il civico). Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. INCROCIO_ID VARCHAR2(32) Codice dell incrocio NODO_ID NUMBER Codice del nodo dell incrocio TIPO_COORD VARCHAR2 (10) Codice di identificazione del tipo di coordinata del civico (UTMRER,WGS84, ) INC_X NUMBER Coordinata X dell incrocio INC_Y NUMBER Coordinata Y dell incrocio GR_AFFIDABILITA NUMBER(3) Grado di affidabilità della riga restituita. Valori bassi indicano una maggiore affidabilità. 0 indica la massima affidabilità. NUMERO_RIGHE NUMBER(3) Totale delle righe restituite NUMERO_RIGA NUMBER(3) Numero della riga restituita ordinata per gr_affidabilita Il rowset conterrà gli incroci ottenuti tramite gli algoritmi di ricerca. La procedura individuerà prima i due toponimi corrispondenti, poi procederà a trovare gli incroci corrispondenti ai toponimi individuati. Se l'incrocio viene identificato univocamente, il cursore conterrà solo l'incrocio individuato. Altrimenti verranno restituiti più incroci, con associati il grado di affidabilità del risultato (0 = via identificata con certezza, > 0 incerto). Le righe del cursore ritornato sono ordinate per livelli di affidabilità decrescenti. e-geocoding Guida ai Servizi Web Pag. 24 di 26

7. Servizi per la Restituzione di Geometrie Le funzioni che consentono di ottenere le coordinate geografiche di una strada o di un civico sono la Get_Str_Geom e la Get_Civ_Geom. 6.6.2 Get_Str_Geom La Get_Str_Geom richiede in input l identificativo dell entità e restituisce le coordinate geografiche del relativo rettangolo circoscritto e del centroide, secondo il sistema di riferimento specificato. Parametri: Nome Parametro Tipo Descrizione INPUT: p_entita_id VARCHAR2(32) Codice entita della strada p_tipo_coord VARCHAR2 Tipo di coordinata che si vuole venga restituita (UTMRER,WGS84, ) p_handle VARCHAR2 Handle di autenticazione OUTPUT: MIN_X NUMBER Coordinata X MIN della strada, del tipo richiesto MIN_Y NUMBER Coordinata Y MIN della strada, del tipo richiesto MAX_X NUMBER Coordinata X MAX della strada, del tipo richiesto MAX_Y NUMBER Coordinata Y MAX della strada, del tipo richiesto CENTR_X NUMBER Coordinata X del centroide della strada CENTR _Y NUMBER Coordinata Y del centroide della strada p_result_code NUMBER Codice restituito in OUTPUT, contenente un codice identificativo del successo della ricerca o del motivo dell insuccesso (0 la ricerca è andata a buon fine, > 0 la ricerca ha incontrato degli errori, I codici errore sono inseriti nella tabella GEOS_T_MESSAGGI) e-geocoding Guida ai Servizi Web Pag. 25 di 26

6.6.3 Get_Civ_Geom La Get_Civ_Geom richiede in input l identificativo dell entità associata al numero civico e restituisce le coordinate geografiche del punto associato alla proiezione sull edificio o sull arco strada più vicino, secondo il sistema di riferimento specificato. Parametri: Nome Parametro Tipo Descrizione INPUT: p_entita_id VARCHAR2(32) Codice entita del civico p_tipo_coord VARCHAR2 Tipo di coordinata che si vuole venga restituita (UTMRER,WGS84, ) p_rif_geo_civ VARCHAR2 Tipo di coordinata che si vuole venga restituita (ECIV,PCIV, ) p_handle VARCHAR2 Handle di autenticazione OUTPUT: CIV_X NUMBER Coordinata X MIN del civico, del tipo richiesto CIV_Y NUMBER Coordinata Y MIN del civico, del tipo richiesto p_result_code NUMBER Codice restituito in OUTPUT, contenente un codice identificativo del successo della ricerca o del motivo dell insuccesso (0 la ricerca è andata a buon fine, > 0 la ricerca ha incontrato degli errori, I codici errore sono inseriti nella tabella GEOS_T_MESSAGGI) e-geocoding Guida ai Servizi Web Pag. 26 di 26