> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/geo-localizzare-una-pratica-il-componente-address.md).

# 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.

{% hint style="warning" %}
Il componente **non deve essere contenuto** all'interno di componenti "[Datagrid](/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/il-datagrid.md)"
{% endhint %}

### Aggiungere il componente Address al modulo

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

<figure><img src="/files/wAM40o3UQS3Wb9rf97h2" alt=""><figcaption></figcaption></figure>

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.

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="/files/EK9FiqvhHDJOepWNYxSP" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/UboiCVSuW5At7obxeDb0" alt=""><figcaption></figcaption></figure>

***

### 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.**

<figure><img src="/files/ciIaTpm7o5KAMck9vxPy" alt=""><figcaption></figcaption></figure>

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

<div><figure><img src="/files/Kd6HeXm1PCPE8Lzg4a0N" alt=""><figcaption></figcaption></figure> <figure><img src="/files/jK2O2nRFslhNTx7bHXJ5" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Le aree geografiche non sono pre-configurate: è necessario aggiungerle manualmente prima di associarle al componente Address map.
{% endhint %}

### 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`.

<figure><img src="/files/FJJw6lzFilCZpocQLl5l" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/3V0BwahbmZ3MwxxewumY" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/geo-localizzare-una-pratica-il-componente-address.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.