Geo-localizzare una pratica: il componente Address

Geo-localizzare una pratica significa associare a un indirizzo inserito dal cittadino le corrispondenti coordinate geografiche. Questo arricchisce i dati della pratica con informazioni spaziali che puoi usare per visualizzare le richieste su mappa e filtrare le pratiche per area territoriale.

Il componente Address

Il componente Address combina un campo di testo con autocompletamento e un motore di geocodifica: mentre il cittadino digita l'indirizzo, il componente suggerisce le corrispondenze e, una volta selezionata la voce, struttura automaticamente i dati nei seguenti sottocampi:

• street_address — via e numero civico;
• address_locality — comune;
• postal_code — CAP;
• county — provincia;
• address_country — paese.

Il componente non deve essere contenuto all'interno di componenti "Datagrid"

Aggiungere il componente Address al modulo

Per geolocalizzare una pratica, trascina nel modulo il componente "Address".

Nella sezione "Provider" del componente, imposta OpenStreetMap Nominatim come provider. OpenStreetMap Nominatim (https://nominatim.org/) è il provider di geocodifica open source che utilizza i dati di OpenStreetMap per trovare luoghi a partire da un nome o un indirizzo. È il provider consigliato perché non richiede chiavi API ed è gratuito.

La disponibilità dei luoghi dipende da OpenStreetMap: essendo un progetto collaborativo, i dati possono essere corretti o integrati direttamente dalla community, ma non dall'interno della piattaforma.

Infine, nella sezione "API", verifica che il property name indicato sia "address".

---

Il componente Address map

Address map è un componente che permette di selezionare l'indirizzo direttamente dalla mappa. Il cittadino può vedere la posizione selezionata direttamente nel modulo, confermando visivamente la correttezza dell'indirizzo inserito.

Configurare le aree geografiche

Nelle impostazioni del tenant è possibile definire specifiche aree geografiche. Una volta configurate, il componente Address map le utilizza per limitare i punti validi selezionabili sulla mappa, circoscrivendo le segnalazioni o le prenotazioni a un territorio definito — ad esempio il solo territorio comunale.

Per aggiungere un'area geografica accedi alla piattaforma come admin e vai in Impostazioni. Seleziona la voce Aree geografiche.

Clicca su Aggiungi area e configura i confini dell'area desiderata seguendo le indicazioni riportate.

Le aree geografiche non sono pre-configurate: è necessario aggiungerle manualmente prima di associarle al componente Address map.

Aggiungere il componente Address map al modulo

Per usare questo componente trascina nel modulo il componente "Address map".

Nella sezione API, verifica che il property name indicato sia address.

Il campo permetterà al cittadino di selezionare un indirizzo all'interno delle aree geografiche configurate.