TrovaBorghi

TrovaBorghi è un'applicazione web che permette di cercare città italiane in base alle lettere iniziali e finali del loro nome. L'app visualizza i risultati sia in formato testuale che su una mappa interattiva, grazie all'integrazione di Folium.

Funzionalità principali

Ricerca di città: Cerca città italiane inserendo lettere iniziali e finali.
Mappa interattiva: Visualizza le città trovate su una mappa dinamica.
Responsive design: Utilizzo di Bootstrap per garantire un'interfaccia user-friendly su dispositivi di tutte le dimensioni.
Contatore degli accessi: Mostra il numero di accessi all'applicazione.

Tecnologie utilizzate

Flask - Microframework per il backend Python.
Folium - Libreria per la visualizzazione delle mappe.
Bootstrap - Framework front-end per lo stile e il layout responsive.
Python - Linguaggio di programmazione utilizzato per il backend.

Utilizzo da browser

Per usare il progetto come webapp premi qui --> TrovaBorghi

Installazione locale

Segui questi passaggi per eseguire l'applicazione in locale:

Clona il repository GitHub:

git clone https://github.com/CheckSim/TrovaBorghi.git
cd TrovaBorghi

Crea un ambiente virtuale (opzionale ma consigliato):

python -m venv venv
source venv/bin/activate  # Su Windows usa `venv\Scripts\activate`

Installa le dipendenze:
```
pip install -r requirements.txt
```
Avvia il server Flask:
```
flask run
```
Apri il browser e vai all'indirizzo:
```
http://127.0.0.1:5000/
```

Come usare l'app

Inserisci i criteri di ricerca: Nella home page, inserisci le lettere iniziali e finali delle città che vuoi cercare.
Visualizza i risultati: Dopo aver premuto il pulsante "Cerca", verranno visualizzate le città che corrispondono ai criteri, insieme alla loro posizione su una mappa.
Controlla il contatore: Nel footer della pagina è presente un contatore che mostra il numero totale di accessi all'app.

Esempio di utilizzo

Se inserisci "Pa" come lettere iniziali e "a" come lettere finali, verranno visualizzate città come Padova, Pavia, ecc., insieme alla loro posizione sulla mappa.

Screenshot

Contributi

Se desideri contribuire al progetto, sentiti libero di fare una pull request. Le discussioni sono benvenute per migliorare l'applicazione.

Come contribuire

Fai un fork del progetto.
Crea un branch per le tue modifiche (git checkout -b feature/nome-della-feature).
Commit delle tue modifiche (git commit -am 'Aggiungi una nuova feature').
Pusha il branch (git push origin feature/nome-della-feature).
Apri una pull request.

Licenza

Questa applicazione è rilasciata sotto licenza GNU GPL 3.0. Puoi consultare il file LICENSE per ulteriori informazioni.