Home

T-Rex

Aplikace umožňuje sledování pohybu zařízení Android a zasílání pozic na definovaný server.

Instalace

• Podporován je Android 4.1 - 6.x
• V zařízení musí být nainstalovány Google Play Services (na této stránce klikněte na ikonu s tooltipem Google Play Services a postupujte dle načtené stránky)
• V zařízení je nutné mít povolenou instalaci aplikaci z neznámých zdrojů (mimo Google Play). Popis např. zde: http://www.cnet.com/how-to/how-to-install-apps-outside-of-google-play/
• Aplikaci je možné stáhnout přímo v zařízení ve webovém prohlížeči z URL: http://distrib.tmapy.cz/pub/distrib/t-rex/index.html. Stažení aplikace je nutné potvrdit.
• Po stažení je možné spustit instalaci přímo z nástroje Stahování, nebo z jiného souborového manažera, ve kterém kliknutím na soubor t-rex.apk instalaci spustíte.

Nastavení

• V menu Nastavení je nutné zadat minimálně dvě zvýrazněné položky
• Identifikátor zařízení - řetězec, který identifikuje zařízení
• URL adresa - adresa serveru, kam se mají pozice odesílat
• Přístupový klíč - řetězec, který se použije při ověření příchozí zprávy na serveru. Musí se shodovat s klíčem, který je uložený v nastavení serveru, aby byla data přijata. Pokud server nevyžaduje ověření příchozích dat, nemusí být vyplněn.
• Další nastavení umožňují zpřesnit způsobe lokalizace a odesílání pozic na server
• Frekvence lokalizace - interval ve kterém bude zařízení zjišťovat svoji polohu (uvedený ve vteřinách)
• Vzdálenost, vyvolávající odeslání - vzdálenost od naposledy odeslané pozice, která vyvolání nového odeslání pozice na server (v metrech). Např. hodnota 100 znamená, že pokud je zařízení alespoň 100 metrů od poslední odeslané pozice, tak se aktuálně zjištěná pozice odešle. Pokud je vzdálenost kratší, tak se pozice neodesílá (pokud ovšem není splněna podmínka odeslání na základě frekvence (viz. níže))
• Frekvence odesílání - nejdelší časový interval, ve kterém je pozice odesílána na server. Předpokládá se, že tento interval bude delší, než frekvence zjišťování polohy. Tento interval je vhodné nastavit podle toho jak má zařízení často odesílat pozici v případě, že se nepohybuje a není tak splněna podmínka minimální vzdálenosti (viz. výše).
• Obvyklá rychlost - nastavení filtrování poloh z GPS. Díky tomuto filtru jsou eliminovány polohy, které neodpovídají skutečnosti, díky snížené přesnosti zaměření GPS. V nastavení by měla být uvedena hodnota, která odpovídá zhruba průběrné rychlosti pohybu, v metrech za sekundu. Může být o něco vyšší - např. pro chůzi je vhodná hodnota 3m/s.
• Způsob lokalizace - na výběr je několik metod lokalizace zařízení. Čím vyšší přesnost, tím větší spotřeba energie během lokalizace.
• Počet uložených záznamů - počet záznamů o trase, které se mají ukládat v zařízení. Neukládají se celé trasy, ale pouze souhrnné informace o trase jako celku.
• Typ aktivity - pokud je tato volba zapnut, je možné vybrat, nebo zadat typ prováděné aktivity, který je odesílán společně s daty na server.
• Vyhledávání adres - pokud je volba zapnuta, vyhledávají se průběžně k jednotlivým polohám informace o adrese. Zvyšuje se množství přenesených dat.
• Nevypínat obrazovku při lokalizaci - pokud je tato volba nastavena, tak zařízení nevypíná obrazovku při běžící lokalizaci zařízení
• Spustit lokalizaci po startu systému - pokud je volba nastavena, tak se lokalizace spustí automaticky po spuštění zařízení (resp. po nastartování systému Android)
• Kontrolovat aktualizace - při zaškrtnutí této volby bude aplikace při startu automaticky provádět kontrolu nových verzí.

Uživatelské rozhraní

Rozhraní aplikace je rozděleno na část s aktivními údaji o probíhající lokalizace a část s přehledem minulých tras.

Aktivní údaje

V části s aktivními údaji se zobrazují údaje o probíhající lokalizaci. Aktualizují se vždy s další polohou. Zobrazují se následující informace:

• Doba probíhající lokalizace
• Celková vzdálenost
• Aktuální rychlost (symbol běžícího panáčka)
• Aktuální nadmořská výška (symbol hor)
• Aktuální přesnost GPS (symbol terče)
• Čas poslední odeslané polohy na server (symbol odpočítávání)
• Stav komunikace se serverem (symbol protilehlých šipek)
• Poslední známá adresa (symbol města)

Pod těmito údaji se zobrazuje tlačítko pro výběr a nastavení typ prováděné aktivity. Pokud se nezobrazuje, je nutné ji zapnout v nastaveních aplikace. Pomocí tohoto tlačítka může nastavit vlastní typ aktivity a u odesílat na server s ostatními daty.

Hlavní červené tlačítko této části aplikace zapíná a vypíná samotnou lokalizaci zařízení.

Přehled tras

V části s přehledem tras se zobrazují souhrnné informace k minulým trasám. Nezaznamenávají se celé trasy, ale pouze agregované informace. Počet uložených tras se dá nastavit v nastavení aplikace.

Smazání vybrané trasy z přehledu se provede podržením prstu na vybrané trase a potvrzením dialogu.

Po spuštění lokalizace je možné okno aplikace zavřít, nebo přejít do jiné aplikace. Lokalizace bude probíhat nadále. V Notifikační liště se objeví zpráva, že je lokalizace T-Rex spuštěna. Kliknutím na tuto zprávu je možné znovu zobrazit hlavní okno aplikace, kde je možné lokalizaci vypnout.

Server

Struktura zasílaných zpráv

• Na server se odesílají data ve formátu HTML formuláře (HTTP metoda POST), kde jsou tyto položky
• i = ID zařízení (libovolný řetězec)
• a = latitude (WGS84) (double)
• o = longitude (WGS84) (double)
• l = nadmořská výška (double)
• s = rychlost pohybu (float)
• b = směr pohybu (float)
• t = čas GPS pozice ve formátu "yyyy-MM-dd'T'HH:mm:ss"
• g = uživatelský popis aktivity (TAG), zasílaný (v každé pozici) ve formátu Base64 (UTF-8)
• k = unikátní bezpečnostní řetězec (klíč) pro zápis zprávy na server

Autentizace klientů, zasílajících data na server

Pro autentičnosti zprávy zaslané na server je možné využít parametr "k" v příchozích datech. V tomto parametru je uložen řetězec, který vznikne dle následujícího zjednodušeného algoritmu:

BASE64(MD5("identifikátor zařízení" + "datum a čas pozice ve formátu yyyy-MM-dd'T'HH:mm:ss" + "uživatelem definovaný přístupový klíč"))

Pokud je uživatelem nastaven stejný "přístupový klíč", jaký je v konfiguraci na serveru, pak je zpráva přijata a uložena.