Smart City API Km4City entry point

Km4City Sii-Mobility SmartCityAPI v1 http://www.disit.org/6977 http://www.disit.org/6991 http://www.sii-mobility.org http://www.km4city.org

Documentazione completa accessibile da http://www.disit.org/6991

API per la ricerca di servizi ed eventi

• Ricerca servizi vicino ad una posizione GPS: data una posizione GPS, la distanza massima, le categorie dei servizi da ricercare ed un eventuale filtro sulle parole che devono essere contenute nei dati associati al servizio

• Ricerca servizi vicino ad un servizio: simile al precedente, la posizione è indicata tramite identificarore di un servizio

• Ricerca servizi in una area geografica rettangolare: simile al precedente solo viene indicata l’area geografica tramite due coordinate GPS

• Ricerca servizi in una area geografica descritta tramite WKT: simile al precedente solo che l’area viene indicata tramite un poligono o una linea espressa tramite formato WKT

• Ricerca servizi in una area preventivamante salvata: simile al precedente solo che l’area geografica è stata precedentemente salvata sul server

• Ricerca servizi per comune: indicando le categorie dei servizi da ricercare ed un eventuale filtro sulle parole da ricercare

• Ricerca serviziper queryId: permette di eseguire una query precedentemente salvata tramite ServiceMap

• Ricerca full text: ricerca full text sui servizi ma anche su toponimi o altre entità georeferenziate

• Ricerca di eventi: attivi il giorno, i prossimi 7 giorni o prossimi 30 giorni, in una certa area geografica espressa con posizione GPS e distanza, area rettangolare, poligono o linea WKT.

• Accesso ad informazioni su un serzizio: tramite identificatore del servizio, restituisce dati diversi a seconda del tipo di servizio, in particolare dati “realtime” per parcheggi (posti disponibili), sensori traffico (flussi veicolari), previsioni meteo, fermate bus (orario e prossimi transiti), pompe benzina (prezzi benzina), pronto soccorso (stato triage) , stazioni qualità dell’aria (contentrazione inquinanti), contatori elettronici, stazioni di ricarica, panchine, irrigatori, lampioni.

• Raccomandazione di servizi: sulla base delle visualizzazioni di servizi fatti da un utente e dalle sue ricerche raccomanda i servizi che potrebbero essere di interesse per l’utente (fornisce anche tweet della protezione civile)

API per la ricerca indirizzi

• Ricerca indirizzo e servizi con geometrie tramite posizione GPS: trova numero civico o il comune data una posizione GPS inoltre può determinare se la posizione indicata è dentro un’area o vicino ad un percorso associato ad un qualche servizio come ZCS, parchi, linee dei trasporti pubblici etc.

• Ricerca posizione GPS tramite indirizzo/nome POI (under development): permette di trovare una posizione GPS associata al nome di una strada, comune e numero civico o ad un punto di interesse

API per il trasporto pubblico

• Lista delle agenzie trasporto pubblico: elenco delle agenzie di trasporto pubblico disponibili (Bus, Tram, Treni, Traghetti)

• Lista delle linee di una agenzia TPL: restituisce l’elenco delle linee gestite da una aganzia di trasporto pubblico

• Lista dei percorsi di una linea: restituisce l’elenco dei percorsi di una linea, anche con la descrizione geografica WKT del percorso

• Lista delle fermate di un percorso: restituisce l’elenco delle fermate di un percorso

• Ricerca dei percorsi che passano in un’area geografica: restituisce i percorsi che hanno almeno una fermata in una certa area geografica indicata tramite posizione GPS e distanza massima, area rettangolare, poligono o linea WKT

• Posizione stimata dei bus: restituisce la posizione stimata dei bus sulla base dell’orario o tramite informazioni provenienti dal sistema di monitoraggio dei mezzi.

API di feedback

• Aggiungere commenti e/o stelle ad un servizio: permette di aggiungere commenti o stelle ad un servizio o evento, i commenti sono validati prima di essere associati al servizio

• Aggiungere foto ad un servizio: permette di aggiungere una foto ad un servizio o evento, le foto sono validate prima di essere associate al servizio.

• Ottenere la lista degli ultimi contributi degli utenti: restituisce l’elenco degli ultime foto inviate dagli utenti, gli ultimi commenti fatti e le ultime valutazioni ricevute.

API per ricerca di percorsi

• Ricerca percorso tra due posizioni GPS o servizi: si può indicare se il percorso deve essere fatto a piedi, con trasporto pubblico, in bici o in macchina.

API tecniche

• Accedere alla cache delle immagini: permette di accedere a versioni ridotte (thumbnail o media risoluzione) di immagini di grandi dimensioni accessibili da web.