Michele Carbini, 309176

EscursioniVeneto

Progetto per sessione estiva piattaforme digitali e per la gestione del territori (10/06/2022).

DESCRIZIONE

Il progetto è stato creato per gestire un file di escursioni in Veneto contenente:

• Provincia

• Denominazione estesa della tratta

• Lunghezza

• Longitudine

• Latitudine

• Tipo di percorso (Percorso principale, Deviazione, Navigazione)

• Nome codificato della tratta

• Partenza della tratta

• Arrivo della tratta

• Tappe intermedie della tratta

La getione consiste nella:

• rimozione di escursioni,
• modifica della lunghezza delle escursioni in caso di errori ricercandole per nome codificato delle tratta
• visualizzazione di tutte le escursioni potendoli filtrare per livello di difficoltà (facile se lunghezza minore di 15km intermedio se compresa tra 15 e 30km e difficile se maddiore di 30km)
• ricerca di un escursione basandosi sul nome codificato della tratta visualizzando una mappa che indica il punto di arrivo dell'escursione scelta

ARCHITETTURA E SCELTE IMPLEMENTATIVE

per l'implementazione ho utilizzato il sito glitch.com aggiungendo le seguenti interfacce grafiche:

• aggiungiPercorso.html
• cercaPercorso.html
• escursioniHome.html
• percDifficile.html
• percFacile.html
• percIntermedio.html
• tuttiPercorsi.html

DATI SFRUTTATI

Per il progetto ho utilizzato un dataset chiamato percorsi.json reperito sul sito DatiOpen.it al seguente indirizzo:

http://www.datiopen.it/en/opendata/Regione_Veneto_Escursioni_giornaliere

API IMPLEMENTATA

Tutte le richieste vengono fatte tramite protocollo HTTP, le API implementate sono le seguenti:

• GET per visualizzazione di tutti i percorsi con URL:https://bronzed-angry-glasses.glitch.me/percorsi
• GET per visualizzazione singolo percorso con URL:https://bronzed-angry-glasses.glitch.me/specPerc
• GET per filto della difficoltà di un percorso con URL:https://bronzed-angry-glasses.glitch.me/diffPercorso/n
• POST per aggiungere escursioni con URL:https://bronzed-angry-glasses.glitch.me/aggiungiPercorso
• PUT per modificare lunghezza escursioni con URL:https://bronzed-angry-glasses.glitch.me/modificaPercorso
• DELETE per eliminare escursioni con URL:https://bronzed-angry-glasses.glitch.me/rimuoviPercorso

INPUT
Nel primo caso non ho valori in input, nel secondo caso in input avrò il nome codificato della tratta (nc) usata per la ricerca, nel terzo caso non ho niente come input, nella POST avrò come input tutti i campi richiesti per la creazione di una nuova escursione, nella PUT avrò come input il nome codificato della tratta (nc) per la ricerca dell'escursione da modificare e la nuova lunghezza (l) da sostituire a quella vecchia, nella DELETE avrò come input il nome codificato della tratta (nc) da rimuovere, per tutti gli input il formato è x-www-form-urlencoded

OUTPUT
Nelle GET l'output sarà una lista di parametri con formato .json richiesti o in caso di errore un messaggio di testo mentre nella POST nella PUT e nella DELETE sarà un messaggio di azione andata a buon fine o no

MESSA ONLINE SERVIZIO

L'elaborazione dei dati verrà gestita dal server, mentre sono state create delle pagine html per la gestione più semplice dei dati. Solo le ultime due funzionalità dovranno essere gestite tramite postman.

ESEMPI DI UTILIZZO

1 - GET di tutte le escursioni richiedendo tutti i dati, la risposta del server sarà la seguente:

2 - GET delle escursioni facili cliccando il pulsante FACILE presente nella schermata precedente, la risposta del server sarà la seguente:

3 - GET di una specifica escursione richiedendo il nome codificato della tratta, la risposta del server sarà la seguente:

4 - POST di una nuova escursione che richiede i campi riportati nell'immagine qui sotto, la risposta del server sarà un messaggio di conferma "Percorso salvato":