- Sessione Autunno 2018/2019
- Luca Grasso
- Matricola 294612
Servizio che consente, tramite una app android, all'utente di cercare una colonnina elettrica per ricaricare la propria auto proponento quella più vicina.
Quindi il progetto si pone come obiettivi primari:
- Ricerca di Colonnina elettrica più vicina con filtro per potenza minima KW impostata da utente.
- Possibilità di inserire un commento per quella colonnina.
Per consentire il corretto funzionamento della piattoforma sono presenti delle richieste GET e POST. I dati sono forniti da OpenChargeMap in formato JSON.
Ho creato un WebAPI installata su Glitch che con metodi Get e Post che comunica con OpenChargeMap e filtra esclusivamente le informazioni che servono al mio Client.
Questo WebAPI realizzato con NodeJS può essere utilizzato da qualsiasi client. Infatti sul server ho anche una versione HTML/JS che ho utlizzato come Test del Webservice.
Documentazione su swaggerhub Documentazione OpenApi Documentazione su gitHub con esempi di chiamate SERVER.md.
Il progetto svolge due funzioni principali:
- La prima consiste nella realizzazione di un applicazione webAPI (GET/POST tramite protocollo HTTP) in NodeJS;
- La seconda invece riguarda l'implementazione di un client Html per i test.
- la terza e ultima parte un semplice client in Java per sistemi Android.
Concettualmente l'intenzione è quella di creare un aiuto per chi cerca una colonnina EV più vicina possibile. Quindi in base al luogo scelto o alla posizione inviata dall'utente, l'API restituira' la colonnina più vicina. Analizzato le numerose informazioni che ricevo da "openchargemap" attraverso la sua API ho scelto di filtrare solamente le informazioni di posizione e minimo power KW che necessita l'utente. Perchè dopo una analisi ho capito che la capità di erogazione determina anche il tipo di attacco necessario e il tempo di ricarica. Quindi ho creato una mia Api appoggiata su glitch che svolge tutte le funzioni GET/POST che necessito.
Come detto in precedenza, mi appoggio alle API di "openchargemap", a questo link guida api openhargemap si trova la guida all'APIche mi restituiranno un json contenete diverse informazioni qua un esempio di una informazione:
Per la parte server come accennato precedentemente, ho utilizzato la piattaforma Glitch come server di appoggio importando la cartella SERVER da git. In essa è presente l'API server.js messa nel main e le cartelle per una interfaccia client HTML/CSS/JS utilizzata principalmente per testare le risposte Get e Post.
La interfaccia è raggiungibile da qua:
- glitch e si presenterà in questo modo
Con l'utilizzo di Android Studio ho creato un applicazione client per sfruttare meglio il servizio creato.
Qua inserisco le mie cordinate e la min power KW che cerco. Ho la possibilita di ricavare la mia posizione. Appena inseriti tutti i dati, l'applicazione abilita il cerca.
viene assegnato un ID all'utente e se viene trovata una colonnina vicina viene proposta se si vuole vedere la distanza attraverso la mappa di google oppure mettere un commento per la colonnina utilizzata
attraverso la posizione ricavata posso aprire googlemaps e farmi indicare la strada.
con l'opzione aggiungi commento, inserisco un commento, apparirà un pop up all'invio.
L'applicazione e servizi sono tutti Open Source / Free to use.
Strumenti:
Code Editor
Il link sottostante collega al sito Swagger con la quale si ha l'opportunità di poter osservare più intuitivamente il comportamento della API, e scaricare la documentazione nel formato OpenApi 3.0.
Questa applicazione ha uno scopo didattico.