GeoGet

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== FoundTime ======
Doplní čas nálezu podle nejbližšího bodu z prošlých stop v GPX souborech. Další skript [[#skript_visittime_pro_zobrazeni_casu_priblizeni_k_vybranemu_bodu|VisitTime]] zobrazí časy přiblížení k vybranému bodu.\\
FoundTime je vhodný pro ty, kteří nepíší nebo nepsali časy do logů, odkud je GeoGet umí standardně importovat.\\
Časy nálezů se hodí pro určení pořadí nálezů v rámci jednoho dne, což je potřeba pro některé [[user:skript:ggstat|statistiky]].

===== Autor =====
  * **[[http://www.geocaching.cz/profile.php?lookup=9140|mpistora]]** / **[[http://www.geocaching.com/profile/?u=PiTeam|PiTeam]]**

===== Automatická instalace =====
~~GEOGET_INSTALL~~

===== Diskuze =====
  * Diskuze o tomto skriptu se nachází na stránkách [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=17453|Geocaching.cz]].

===== Velmi stručný popis použití =====
  - Soubory GPX s prošlými stopami zkopírujte z GPS do složky v počítači.
  - Spusťte v GeoGetu skript FoundTime. Ten se pro keše bez času nálezu pokusí najít nejbližší bod ze dne nálezu, a jeho čas doplní do databáze GeoGetu.

===== Velmi podrobný popis použití =====

==== Vyluštěné finálky mysterek ukládejte jako waypointy ====
Není to nutné, ale pokud jsou finální souřadnice daleko od výchozích a pokud nebudou uložené v databázi GeoGetu, nemůže skript FoundTime čas nálezu správně určit.\\
[[user:menu:waypointy|Finální waypointy ]] můžete uložit i kdykoliv později, ale pokud je uložíte včas, budou zahrnuty do exportu do GPS.

==== Při hledání keší zaznamenávejte v GPS prošlou stopu ====
To umožňují snad všechny turistické GPS i aplikace v mobilech a PDA. Jen je to někdy potřeba zapnout. Kromě toho také bývá možno nastavit, jak často se mají body ukládat, aby vzniklé soubory nebyly zbytečně velké.
  * **[[http://www.garmin.com|Garmin]]** (např. eTrex Vista HCx)\\ Umožňuje prošlé trasy pojmenovávat, ukládat a různě s nimi pracovat přímo v interní paměti přístroje. Ale kromě toho standardně ukládá na kartu prošlé trasy do denních souborů GPX - ty jsou pro skript FondTime nejvhodnější. Nastavení:\\ //Hlavni menu -> Prosle trasy -> Nastaveni -> Nastaveni dat. karty -> Ulozit pr. trasu na kartu//
  * **[[http://www.nicque.com/PQz/GCz.htm|GCzII]]**\\ Ukládá veškerý výstup z GPS v NMEA formátu a nelze zapnout na stálo. Nastavení:\\ //Menu -> GPS -> Logging Start//
  * **[[http://pocketdrake.cz|PocketDrake]]**\\ //Nastavení -> GPS -> Povolit záznam stopy//

==== Vyřešené finálky multin ukládejte jako waypointy ====
Není to nutné, ale pokud jsou finální souřadnice daleko od výchozích a pokud nebudou uložené v databázi GeoGetu, nemůže skript FoundTime čas nálezu správně určit.\\
[[user:menu:waypointy|Finální waypointy ]] můžete uložit i kdykoliv později.

==== Prošlé stopy zkopírujte z GPS do složky v počítači ====
Pro účely skriptu FoundTime jsou nejvhodnější denní prošlé trasy z GPS Garmin s názvy ve tvaru ''yyyymmdd.gpx''. Ty lze z karty zkopírovat dvojím způsobem:
  * připojit kabelem a přepnout do režimu externího disku pomocí //Hlavni menu -> Nastaveni -> Propojeni -> USB diskova jednotka//
  * nebo kartu vyjmout z GPS a vložit do čtečky v počítači.

//Tip:// Soubory po zkopírování do počítače z karty z GPS občas smažte. Ač se může zdát, že na kartě zbývá ještě hodně volného místa, jsou i další omezení. Garmin eTrex ukládá GPX soubory do kořenového adresáře a v závislosti na způsobu naformátování zde může být limit 256 položek! Byly zaznamenány případy, že po dosažení 255 GPX souborů (+ složka GARMIN) se další bez varování neukládaly.

Skript zpracuje i GPX soubory s jinými názvy (a obsaženým časovým úsekem), než ''yyyymmdd.gpx'', ale musí se to nastavit v konfiguraci.

==== Pokud nejsou prošlé stopy ve formátu GPX, zkonvertujte je ====
Pokud máte záznam z GPS v jiném formátu, než [[http://www.topografix.com/gpx.asp|GPX]] 1.0 nebo 1.1, je nutno ho před zpracováním skriptem FoundTime do tohoto formátu zkonvertovat. K tomu lze využít např. program [[http://www.gpsbabel.org/|GPSBabel]]. Lze ho využít i pro konverzi souborů GDB (databáze Garmin GPS programu MapSource) a lze ho spouštět z dávek.

==== Spusťte skript FoundTime ====
Při prvním spuštění se skript zeptá na složku s GPX soubory a uloží si ji do konfigurace. Další možnosti konfigurace jsou popsány [[#nastaveni_a_konfigurace|níže]].

Skript:
  - Zpracuje zadané keše (všechny, zobrazené nebo jen vybrané), a z toho jen:
    * nalezené
    * s datem nálezu
    * bez času nálezu (lze vypnout)
  - Pro tyto keše:
    - najde dle dne nálezu příslušný GPX soubor (nebo zpracuje celý adresář GPX souborů)
    - v něm nejbližší bod ke keši resp. finálce (pokud je v databázi uložen FI waypoint)
    - pomocí [[http://www.geonames.org/export/web-services.html#timezone|geonames.org]] najde časovou zónu v daném bodě
    - UTC čas bodu pomocí [[http://www.geonames.org/export/web-services.html#timezone|timezoneconverter.com]] převede do místního času bodu
    - výsledný čas doplní k datu nálezu keše do pole čas nálezu keše v databázi GeoGetu
    - a poznamená i do tagu FoundTime (s přesností na sekundu ;-) a s časovou zónou).
  - Na závěr zobrazí hlášení o počtu zpracovaných keší, časech zpracování a případných chybách.

U mystery a multi je trochu nesmyslné hledat nejbližší bod dle výchozích souřadnic (lze to vypnout), ale pokud jste výchozí souřadnice navštívili, může to být použitelný výsledek. Proto také lze stanovit toleranci blízkosti.

===== Před prvním spuštěním =====

==== Instalace ====
Instalace se standardně provádí z [[#automaticka_instalace|této stránky]].\\
Všechny 3 skripty pluginu se při instalaci zařadí do skupiny FoundTime. FoundTime a VisitTime zobrazí ikony na [[user:menu:toolbary#Plugin|toolbaru Plugin]].

==== Nastavení a konfigurace ====
Ve [[user:menu:pluginy:spravce_pluginu|Správci pluginů]] nastavit konfiguraci FoundTime: 
^ Volba  ^ Výchozí\\ hodnota  ^ Možné\\ hodnoty  ^ Popis  ^
| **SlozkaGPX** |  | //cesta// | složka s GPX soubory s prošlými stopami, nejlépe s názvy ve tvaru //FormatNazvuGPX//.gpx (yyyymmdd.gpx)\\ toto je jediný parametr, který je musí být nastaven\\ pokud není nastaven, tak se skript na složku zeptá, a uloží do tohoto konfiguračního parametru |
| **FormatNazvuGPX** | yyyymmdd |  | nevyplněno - prohledají se všechny GPX soubory v adresáři |
| ::: | ::: | //format// | formát názvu GPX souborů s denními úseky (např. yyyymmdd)\\ v syntaxi funkce ''FormatDateTime'' Pascalu\\ prohledá se jen soubor pro požadovaný den |
| **Rozsah** | list |  | nevyplněno - zpracují se pouze vybrané keše |
| ::: | ::: | list | zpracují se všechny keše ze zobrazeného seznamu\\ ať už vznikl podle filtru nebo dalšími úpravami |
| ::: | ::: | global | zpracují se všechny všechny keše z databáze\\ při každé z variant se ještě uplatní další podmínky pro výběr keše |
| **TimeZone** |  |  | nevyplněno - zjišťování časové zóny a převody času se provádí přes web |
| ::: | ::: | //timezoneid// | TZ dle [[http://en.wikipedia.org/wiki/List_of_tz_database_time_zones]], např. Europe/Prague\\ o všech bodech se předpokládá, že jsou ze zadané časové zóny\\ přes web se provádí jen převod času |
| ::: | ::: | PC | o všech bodech se předpokládá, že jsou z časové zóny aktuálně nastavené v PC\\ převody času se provádí funkcemi GeoGetu |
| **GeoNamesUsername** |  | //username// | registrované na [[http://www.geonames.org/login]]\\ server se používá pro zjištění časové zóny bodu\\ za registraci poskytuje služby z vyšší dostupností |
| **PozadovanaBlizkost** | 50 | //číslo// | jen body z GPX bližší než zadaný počet metrů se budou považovat za nález keše resp. finálky |
| **PrepisovatFoundTime** | 0 | 0 | keše s časem nálezu nebo s tagem FoundTime se nevyberou ke zpracování |
| ::: | ::: | 1 | zpracují se, a dříve zapsaný čas se tak může přepsat! |
| **PozadovatFinalky** | 0 | 0 | finálky se nepožadují |
| ::: | ::: | 1 | pro zpracování multi a mystery keší musí být zadány souřadnice finálního bodu |
| **ChybyDoTagu** | 0 | 0 | chyby se neukládají (jen se zobrazí na konci běhu skriptu) |
| ::: | ::: | 1 | text chyby se uloží do tagu FoundTime |

==== Nastavení seznamu ====
Pro práci s FoundTime je dobré si v seznamu keší zobrazit tag FoundTime, který skript nastavuje.\\
V [[:user:menu|menu]] //Nástroje -> Editor sloupců// spusťte [[user:menu:nastroje#editor_sloupcu|Editor sloupců]], z dostupných sloupců přesuňte ''Kategorie tagů'' do pravé části a do //Vlastnosti sloupce -> Kategorie tagů:// zadejte ''FoundTime'' (dokud tag není v databázi, není zde v nabídce).

Sloupec s tagem si zařaďte vedle sloupce ''Nalezená''. Ujistěte se, že se v něm zobrazuje i čas. To lze případně upravit v //Nástroje -> [[user:menu:nastroje:nastaveni|Nastavení]]//.

Jelikož skript pracuje jen s nalezenými kešemi, je vhodné použít standardní filtr **Found** (pomocí [[user:menu:toolbary#Plugin|toolbaru Filtr]]).

==== Skript DeleteFoundTime pro smazání falešných časů nálezů ====
Prohlédněte časy nálezů keší ve sloupci ''Nalezená''. I když jste časy do logů na [[http://www.geocaching.com]] nepsali, mohou se u některých keší objevit. Buď jste nějaký čas přeci jen do textu logu napsali - pak je to v pořádku. Nebo jste log dodatečně editovali, v logu se objevilo něco jako ''This entry was edited by PiTeam on Tuesday, 28 September 2010 at 12:23:25.'' a GeoGet to bez rozpaků naimportoval do času nálezu. Pak to v pořádku není a pro opravu, resp. smazání takového času z databáze GeoGetu slouží pomocný skript **DeleteFoundTime**.

Nemá žádnou konfiguraci a pracuje nad aktuálně zobrazeným seznamem.\\
Spustí se z menu //Pluginy -> FoundTime -> DeleteFoundTime//.\\
Smaže čas nálezu, pokud je stejný, jako záznam o editaci nálezového logu ve tvaru ''This entry was edited by PiTeam on Tuesday, 28 September 2010 at 12:23:25.''. Datum nálezu ponechá.

==== Složka s GPX soubory s prošlými stopami ====
Připravte si kdekoliv na disku složku, do které shromáždíte GPX soubory s prošlými stopami. Nejen z posledního výletu, ale za celou vaši historii. Prohledejte všechny disky na všech svých počítačích. Hledejte i soubory gdb a zkonvertujete je na GPX pomocí [[http://www.gpsbabel.org/|GPSBabel]]. Při konverzi nastavte filtr, který odfiltruje ''Routes'' a ''Waypoints'' a ponechá jen ''Tracks''.
Složku nastavte do konfiguračního parametru **SlozkaGPX**.

===== Skript VisitTime pro zobrazení časů přiblížení k vybranému bodu  =====
Bonusový skript, který pro vybranou keš projde všechny GPX soubory v daném adresáři a vypíše všechny //návštěvy// tohoto bodu (z každého GPX souboru nanejvýš jednu v zadané toleranci).\\
Skript používá konfiguraci skriptu FoundTime, zejména **SlozkaGPX** a **PozadovanaBlizkost**.\\
Předpokládá, že v seznamu keší v okně GeoGetu je vybrána jedna keš.\\
Výsledky zobrazí v okně s hlášením.
 
===== Technické poznámky =====

==== Terminologická poznámka ====
//Track, tracklog, prošlá trasa, stopa a prošlá stopa// - to všechno jsou synonyma.\\
Garmin se snaží používat //prošlá trasa//, ale občas mu do toho pronikne //stopa//.\\
Aby se to ostřeji odlišilo od //trasa (route)//, používám zde //prošlá stopa//.\\
Ono se to moc neliší, jen body v //prošlých stopách// mají méně atributů. V minimální variantě jen souřadnice, obvykle mají čas, mohou mít i výšku, ale nemají název, ikonu apod. V GPX apod. souborech jsou uloženy od tras odděleně.

==== Problém zjištění místního času z GPX ====
Předpokládám, že datum do logů na [[http://www.geocaching.com]] se píše podle data v místním čase v místě nálezu keše. Ovšem do tracklogů v GPX souborech se ukládá časový údaj zásadně v čase [[http://cs.wikipedia.org/wiki/Coordinated_Universal_Time|UTC]]. Pokud chceme z takového záznamu zjistit, jaký byl v daném bodě místní čas, musíme zjistit:
  - jaká tam (tehdy) byla časová zóna
  - jaké ta zóna má (tehdy měla) vlastnosti, resp. posun oproti UTC (včetně případného letního času)
Jelikož časové zóny mají hranice často na hranicích států a definice vlastností časových zón se občas mění (i definice států a jejich hranic), nejde o nějaký triviální výpočet, resp. je k němu potřeba velké množství dat. Například až nejnovější GPS Garmin (Oregon) obsahují (aktuální) mapu časových zón a umí automaticky přepočítávat na místní čas.
Databáze časových zón [[http://www.twinsun.com/tz/tz-link.htm]] sice existuje ve formě knihovny pro Deplhi, ale pro nějaké o hodně modernější než je v GeoGetu.
Složitější úloha s mapou hranice časových zón by možná šla pojmout jako nějaké polygony, ale nejjednodušší je použít webové služby.

Nenašel jsem ovšem žádnou, která by pro zadané GPS souřadnice a (minulý) UTC čas vrátila (tehdejší) místní datum a čas.
Na [[http://www.geonames.org/export/web-services.html#timezone]] jsem našel službu pro přepočet souřadnic na časovou zónu (je hned vedle služby, kterou používá skript [[user:skript:elevation|Elevation]]). Jen teoretický problém je, že pracuje s aktuálními hranicemi.
Na druhou operaci jsem nenašel webovou službu, ale jen stránku [[http://www.timezoneconverter.com/cgi-bin/tzc.tzc]], která převádí i starší časové údaje mezi velkou nabídkou časových zón.

Druhý problém je, zda lze spolehnout na segmentaci prošlých stop tak, jak je vytváří Garmin. Zda body z //jednoho dne// jsou v jednom souboru, a jak je vlastně ten //jeden den// definován. Zdá se, že nikoliv dle UTC času, ale podle místního času (dle nastavení GPS). To je pro naše účely vhodné. Ale nevím, zda na to lze spolehnout.\\

Skript nyní podporuje dle konfigurace i variantu, že prohledává všechny soubory v zadaném adresáři bez ohledu na název souboru. Nejdříve si však spočítá, jaký byl UTC čas na začátku a konce dne nálezu v místním čase. Ani to není triviální, někdy někde mají dny 23 nebo 25 hodin 8-o. Používá k tomu výše zmíněné metody. 

==== Prohledávání GPX souborů ====
Skript používá pro parsování GPX souborů [[http://msdn.microsoft.com/en-us/library/ms766487(v=VS.85).aspx|Msxml2.DOMDocument.6.0]] dle [[user:skripty:com|Volání COM/OLE objektů]].\\
[[http://www.w3.org/TR/xpath/|XPath]] dotaz jsem doplnil o předběžnou filtraci dle //časoprostorového kvádru// - tedy jak omezujících časů, tak i omezujících souřadnic. S omezením souřadnic je problém okolo pólů (ze čtverců tam jsou trojúhelníky 8-o) a poblíž 180. poledníku. Je to pravda trochu teoretický problém, protože na pólech (zatím) žádné keše nejsou.\\
Použil jsem algoritmus dle [[http://janmatuschek.de/LatitudeLongitudeBoundingCoordinates]] (Jan Philip Matuschek).
Lze tak prohledávat velké GPX (třeba sloučené za celý rok).

==== Knihovny ====
Plugin obsahuje 4 [[user:skripty:unit|unity]]:
^ TimeConversions | Hledání časové zóny v daném bodě, převod času mezi zónami, převod do a z několika textových formátů. |
^ TrackLogParser | V daném GPX souboru s tracklogem najde nejbližší záznam podle několika možných kritérií. |
^ SaveConfig | Uložení změny konfiguračního parametru do souboru *.config.pas. |
^ GeoLocation | Hledání omezujících souřadnic k zadanému bodu na kouli a kruhu kolem něj. |

/* ===== Poznámky, známé problémy ===== */

===== Stažení =====
<box round 95% #DEE7EC>
:!: Stáhnout aktuální verzi: ~~DOWNLOAD foundtime-*.gip highest~~
</box>

==== Seznam dostupných verzí ====
{{filelist>foundtime:*.gip&style=table&tableheader=1&tableshowdate=1&sort=mtime&limit=1}}

===== Seznam změn =====

=== 1.0.2 (2011/11/04) ===
   * Instalátor vytváří skupinu FoundTime a zapíná ikony na toolbaru
   * Oprava skriptu DeleteFoundTime (přepočet AM/PM časů)

=== 1.0.0 (2011/02/15) (počet stažení: 202) ===
   * Úvodní verze

/* Seznam tagů. Tagy můžete stránce přidělit buď ručně na následující řádce, nebo pomocí zatržítek v zápatí editačního okna */
{{tag>author_mpistora skript ggp gpx}}