Dokumentace - SteveUhercik/CallBox GitHub Wiki

Dokumentace

Příprava dat - modul dataconversion

Převod CSV do XML

Tato funkcionalita je implementována ve třídě cz.muni.fi.pb138.dataconversion.CsvToXml

Návod k použití: CsvToXml "cesta ke vstupnímu CSV souboru" "cesta k výstupnímu XML"

Příklad argumentů použitý v projektu: ../data/callBoxList.csv ../data/callBoxes.xml

Geokódování telefonních automatů

Geokódování je proces přeměny poštovní adresy na geografické souřadnice. K tomu bylo využito Google Geocoding API. Geokódování provádí třída cz.muni.fi.pb138.dataconversion.GeocodingUtils.

Návod k použití: GeocodingUtils "cesta k vstupnímu XML" "cesta pro uložení výstupního XML" "XSD schema výstupního XML" "počíteční index" "koncový index"

Google Geocoding API dovoluje pouze 2500 dotazů za 24 hodin z jedné IP adresy. Proto rozdíl mezi počátečním indexem a koncovým indexem by neměl být větší než 2500.

Příklad argumentů použitý v projektu: ../data/callBoxList.xml ../data/callBoxListWithGeocoding_4801-6000.xml ../data/callBoxesWithGeocoding.xsd 4801 6000

Mapa telefonních automatů - modul callboxesmap

Na serveru byly použity Java Servlety běžící na Apache Tomcat 8. Na straně klienta bylo použito Google Maps JavaScript API v3 k zobrazení mapy a jQuery pro komunikaci se serverem a dynamické prvky stránky. Webová aplikace se skládá ze dvou částí nazvaných jako verze 1 a verze 2.

Verze 1

Tato verze svou funkcionalitou odpovídá zadání. Je možno podle zadaných geografických souřadnic vyhledat a zobrazit telefonní automaty v okolí a nebo zobrazit všechny automaty ve zvoleném kraji okrese či obci.

Verze 2

Verze 2 více využívá síly Google Maps JavaScript API v3. Narozdíl od verze 1, jsou v mapě zobrazeny všechny telefonní automaty a uživatel může zadat adresu pomocí komponenty SearchBox, využívajíci Google Place Autocomplete funckionalitu, nebo může na mapě zazoomovat na svoji aktuální lokaci s využitím HTML5 Geolocation.