POI Garmin

Skript, který exportuje z Geogetu GPX soubory vhodné pro použití s POI Loaderem. Pomocí POI Loaderu je možné nahrát soubory do navigace jako Vlastní body zájmu - neboli POI.

Skript je určen především pro nejnovější Garmin GPS zařízení - Colorado, Oregon, Dakotu, GPSMap 62, ale je bez problémů použitelný takřka s jakoukoliv navigací Garmin. Skript je vhodný i pro užití s programem Garmin XT, tedy SW od firmy Garmin pro mobilní zařízení (Symbian, Windows Mobile).

Skript používá ke své práci knihovnu VarSubst, která je univerzálním nástrojem pro generování uživatelsky konfigurovatetlného výstupu. Kromě funkcí integrovaných v knihovně poskytuje uživateli i další funkce (viz oddíl níže).

Díky tomu je skript zcela univerzální a je možno jej užít pro generování GPX i pro starší GPS, například pro Garmin řady eTrex, pro které ale existuje i skript specializovaný).

Výchozí nastavení skriptu je šito na míru novým přístrojům - Colorado, Oregon, Dakota, GPSMap 62. Pokud jej chcete použít se starším zařízením - řady eTrex nebo GPSMap - můžete si změnou jedné položky v konfiguraci kompletně změnit generovaný výstup. Stačí nastavit hodnotu TEMPLATE_FOLDER na templates\etrex. Více informací o významu jednotlivých položek najdete níže v dokumentaci.

S tímto skriptem používejte vždy nejnovější verzi programu Geoget. Pokud si nevíte rady s instalací Geogetu, instalací skriptu, filtrováním keší či exportem, udělejte si pohodlí a přečtěte si nápovědu.

Podobnou problematikou se zabývá i ProKešTomovo makro GeoPOI. Zkuste na něj mrknout, třeba se Vám zalíbí.

Pokud se Vám doplněk líbí, kliknutím na tlačítko Donate můžete přispět na jeho vývoj.

Nekamarádíte se s PayPalem? Napište mi email a domluvíme se na jiném způsobu, třeba převodu na účet.

• Diskuze o tomto skriptu se nachází na stránkách Geocaching.cz.

Výstup skriptu (s výchozími šablonami) je velice podobný mému exportnímu skriptu do GPX pro Garmin GPS. Díky šablonám je však možno si výstup zcela přizpůsobit k obrazu svému. K tomu slouží editor šablon, který je k dispozici pod položkou POI Garmin - editor šablon v menu pluginy přímo v GeoGetu.

Šablona je textový soubor s “příkazy” pro knihovnu VarSubst, která se stará o tvorbu výstupu. Šablony můžete libovolně upravovat a výstup si tak konfigurovat. Dokumentaci k obsahu šablon, možným příkazům a nastavením najdete na stránce knihovny VarSubst.

Kromě standardních knihovních proměnných poskytuje export ještě tyto proměnné k nahrazení:

Zde příkládám seznam voleb, které je možno nastavit v konfiguračním souboru tohoto makra. Seznam můžete brát jako nápovědu či jako přehled schopností exportu. Každou z těchto funkcí lze volitelně zapnout či vypnout.

• EXPORT_FOLDER - Složka, do které se uloží výsledné exportované soubory. Pokud ji nedefinujete, skript se pokaždé na cestu zeptá. V konfiguraci lze použít relativní (vůči datovému adresáři GeoGetu) nebo absolutní cestu.
• EMPTY_FOLDER - Vymazat před započetím exportu všechny soubory z cílového adresáře?
• EXPORT_GEOCACHES - Exportovat kešky? (Hlavní body)
• EXPORT_WAYPOINTS - Exportovat waypointy? (Vedlejší body)
• EXPORT_LOGS_MAXCOUNT - Maximální počet logů k exportu
• PROXIMITY_CATEGORIES - Seznam kategorií bodů (oddělovač '|'), na které bude upozorňováno při přiblížení na vzdálenost PROXIMITY_DISTANCE metrů.
• SHOW_ERRORS - Zobrazovat chyby? Vypnutí této funkce je vhodné pro použití při zpracování makrem Combine.
• CLEANUP_HTML - Vymazat z logu a listingu pro Garmin GPX zbytečné HTML tagy
• REPLACE_IMAGES - Všechny obrázky v listingu nahradí za upozornění, že zde byl obrázek (a pokud je uveden, zobrazí alternativní text)
• CLEANUP_GROUNDSPEAK_WAYPOINTLIST - Z konce listingu odstraní nepoužitelný seznam waypointů vkládaný Groundspeakem do PQ
• TEXT_HIGHLIGHT - Seznam klíčových slov, která budou v listingu zvýrazněna
• EXPORT_ONLY_FINAL_WAYPOINTS_WHEN_FOUND - U nalezených keší exportovat pouze finální waypointy (aby se nepletly různé stage a questions to answer na mapě)
• ICON_FOLDER - Složka s ikonami. Lze použít relativní (vůči složce se skriptem) nebo absolutní cestu.
• TEMPLATE_FOLDER - Složka se šablonami. Lze použít relativní (vůči složce se skriptem) nebo absolutní cestu.
• TEMPLATE_POINT_NAME, TEMPLATE_POINT_DESCRIPTION, TEMPLATE_WAYPOINT_NAME, TEMPLATE_WAYPOINT_DESCRIPTION - Cesta k šablonám, které definují výstup (jméno bodu, popis bodu, jméno waypointu, popis waypointu). Lze použít relativní (vůči složce se šablonami) nebo absolutní cestu.

• icons - Složka s ikonami. Obsahuje různé sady ikon
  • colorado_dakota_oregon_gpsmap62_original - ikony shodné s ikonami, které pro keše používá Garmin ve svých jednotkách
  • colorado_dakota_oregon_gpsmap62_HuntBehind - upravené ikony od HuntBehinda
  • etrex_mini_Geby - ikonky od Gebyho, které jsou součástí skriptu POI Etrex).

• templates_bundled - Složka s výchozími šablonami, která je automaticky přepisována při instalaci novější verze exportu. Není doporučeno v ní cokoliv upravovat, protože úpravy budou aktualizací přepsány. Obsahuje více jazykových mutací šablon.
  • colorado_dakota_oregon_gpsmap62 - Šablony uzpůsobené pro vyjmenované nové navigace od firmy Garmin
  • etrex - Šablony uzpůsobené pro navigace řady Garmin Etrex. Výstup je téměř shodný se skriptem POI Etrex.

• templates - Složka se šablonami (vytvářená instalačním skriptem dle zvoleného jazyka v GeoGetu). V této složce můžete šablony bez obav upravovat. Úpravy budou zachovány i po instalaci novější verze exportu. Při instalaci skriptu je složka automaticky vytvářena instalátorem a jsou do ní nakopírovány (NE přepisovány!) šablony patřičné jazykové mutace ze složky templates_bundled

• locale - Složka s lokalizací skriptu.

1. Nainstalujte instalační balíček (můžete využít tlačítka pro automatickou instalaci v hlavičce této stránky)
2. V nabídce Pluginy → Správce pluginů → Konfigurace pluginů → poigarmin nastavte export podle svých preferencí. Můžete si vybrat složku s ikonami a šablonami, která Vám vyhovuje.
3. Pomocí editoru šablon Pluginy → (Nezařazené pluginy) → POI Garmin - editor šablon si můžete dále upravit výstup, který export generuje.

1. Vyhledejte v okně GeoGetu požadovaná data a pomocí položky v menu Pluginy → (Nezařazené pluginy) → POI Garmin - GPX pro POI Loader vyexportujte složku se soubory GPX. Výstupní složku volte raději prázdnou.
2. Hotovou složku nechte pomocí programu POI Loader nahrát do navigace.

Máte zájem nahrávání keší do navigace automatizovat? Podívejte se na plugin Combine.

• Možnost uživatelského nastavení kategorizace bodů do skupin pomocí knihovny VarSubst - ověření, zda je to možné a případně implementace.
• Ještě těsnější spolupráce se skriptem GPX Garmin - sloučení společných částí kódu, tvorba integrovaného balíku exportu pro Garmin

• Pro formátování výstupu je nyní použita knihovna VarSubst. Každý uživatel makra si tak může konfigurovat formát výstupu přesně dle svých preferencí
• Upraven způsob zapisování výsledných dat do souboru. Zpracování exportu je nyní rychlejší.
• Přidána možnost definovat si klíčová slova, na jejichž výskyt bude poté prohledáván listing. Každé nalezené slovo bude barevně zvýrazněno a na tuto skutečnost je upozorněno na začátku listingu.
• Přidána možnost upozorňovat na přítomnost bodu, který patří do nějaké kategorie. Kategorie jsou shodné, jako výstupní adresářová struktura. Například “GC\Final Location” nebo “GC - Disabled\Traditional Cache”. Je nutné dodržet velikost písmen!
• Přidána možnost odstraňovat přebytečný seznam waypointů, který Groundspeak vkládá na konec listingu v PQ
• Přidána možnost nechat si v listingu vyznačovat místa, na kterých je obrázek (pokud obsahuje alternativní text, je zobrazen)
• Opravena chyba s interpretací českých znaků, pokud je jako cílová exportní složka zvolena složka obsahující v názvu česká diakritická znaménka
• Použita verze 0.1.3 knihovny Category
• Vylepšena funkce na odstraňování zbytečných HTML tagů v listingu
• Překlad do angličtiny. Added english language version.