GeoGet

Complete geocaching solutions

User Tools

Site Tools


user:skript:labforgg

LabForGg

S příchodem aplikace pro mobilní telefony není možné rozumným způsobem získat informace o Adventure LAB keších a jejich sériích. To sice není problém při vlastním “odehrávání”, ale problém nastává při plánování odlovu zejména spolu s ostatním typem keší nebo při generování statistik. Adventure LAB keše jsou vedeny u geocaching.com zcela samostatně, a jiný přístup než přes mobilní aplikaci není možný.

Proto pod vedením tuláka a ve spolupráci s georabbits.cz, Jazzlinka vznikl postupně server s GPX soubory Adventure LAB keší. Na tomto serveru je možné získat jednotlivé soubory s Adventure LAB kešemi, tyto soubory nahrát do GPS nebo do nějaké aplikace a víceméně s nimi pracovat podobně jako s ostatními typy keší.

Skript LabForGg pak slouží k automatizovanému přístupu na tento server s možností přímého importu dat do GeoGetu.

Druhým využitím skriptu pak je možnost tvorby GPX souboru s Adventure LAB kešemi a jejich nahrání na server, ovšem tato činnost je dostupná jen správcům po zadání autorizačních informací.

Autor

Automatická instalace

Nainstalovat do GeoGetu
Instalaci doplňku spustíte kliknutím na tlačítko vlevo. Následně budete v prostředí GeoGetu provedeni instalačním procesem. Pro zajištění této funkce je třeba mít na počítači již nainstalovaný a spuštěný program GeoGet .
Kliknuli jste na tlačítko a nic se nestalo? Máte opravdu spuštěný GeoGet ? Je to potřeba! Nebo možná máte zastaralý webový prohlížeč. Nevadí, instalaci doplňku můžete jednoduše vyvolat i prostým zkopírováním (označit text → klik pravým tlačítkem → kopírovat) následujícího odkazu do schránky: https://www.geoget.cz/doku.php/user:skript:labforgg?download

Popis

Skript umožňuje vyhledávat Adventure LAB keše (resp. jejich série) podle různých kritérií se stejnými možnostmi jako přes webové rozhraní:

  • podle GC kódu rodičovské keše
  • podle jména série Adventure LAB keší
  • podle autora série Adventure LAB keší
  • podle státu nebo území ve státě
  • podle data a času publikace GPX souboru se sérií Adventure LAB keší na serveru
  • podle dalších příznaků
    • k sérii existuje bonusová keš (většinou mysterka), ta je zároveň rodičovskou keší
    • série je sekvenční (autor Adventure LAB keší pevně stanovil pořadí, v kterém je třeba jednotlivé Adventure LAB keše série navštívit)
    • série byla publikovaná k nějakému eventu (ten pak bývá rodičovskou keší)
    • série byla archivována
  • podle autora GPX souboru, tedy toho, kdo GPX soubor na server nahrál

U skriptu však navíc přibývají možnosti:

  • importovat keše, které byly na server doplněny (nebo upraveny) po určitém datu
  • importovat jen keše, které dosud nejsou v GeoGetu
  • pamatovat si datum posledního importu dat ze serveru (pro každou databázi samostatně)

Tyto funkce jsou tak nástrojem pro snadné udržení aktuálních informací o všech Adventure LAB keších v GeoGetu.

Všechny texty, podle kterých je na serveru hledáno, jsou chápany jako součást položky, ve které se hledá, a vyhledávání probíhá bez ohledu na velikost písmen a diakritiku tak, jak jsme v GeoGetu zvyklí.

Pokud tedy do položky pro autora série zadám jen písmeno e, pak budou vyhledány např. autor Demkes, Démoníci, Děd vševěd i Eliška.

Ukázka

Hlavní obrazovka - vyhledávání ne serveru

Na obrázku je vidět možnosti vyhledávání. Ve vyhledávacím profilu lze vybrat předvolené vlastnosti pro vyhledávání. Po kliknutí na tlačítko Vyhledat se ve spodním seznamu zobrazí série odpovídající vyhledávacím kritériím. Pak tlačítkem Stáhnout lze v seznamu vybrané série stáhnout (jako gpx soubor) nebo rovnou importovat do databáze GeoGetu.

Zaškrtávací políčko Zapamatovat čas importu slouží k tomu, aby si plugin poznamenal aktuální datum a čas a tím pak přiště předvyplnil datum a čas pro vyhledávání. Snadno tak lze nalézt a získat jen série, které byly od poslední aktualizace doplněny nebo změněny, a udržovat tak data v databázi aktuální.

Nastavení pluginu

Pro běžné používání není třeba žádné speciální nastavení, vše by mělo pracovat hned po instalaci.

  • WEB_URL je adresa pro komunikaci se serverem a je nastavená již při instalaci

Jinak je tomu u autorů GPX. V souboru LabForGg.config.pas je nutné nastavit hodnoty:

  • WEBPUB_URL
  • WEBPUB_USER
  • WEBPUB_PWD
  • a případně GPX_AUTHOR_ENABLE (tato hodnota je používaná jen v případě Adventure LAB keší existujících ještě před vytvořením serveru pro sdílení GPX souborů, aby bylo možné zachovat autora původního GPX souboru)

Všechny hodnoty, kromě poslední, přiděluje správce serveru s GPX soubory. Bez jejich smysluplného zadání nebudou v pluginu dostupné funkce pro tvorbu GPX souboru a jeho nahrání na server.

Položka SAVE_DIR slouží k tomu, aby si uživatel mohl definovat adresář, do kterého bude plugin vytvořené GPX soubory ukládat. Pokud adresář není vyplněn, plugin použije DATADIR.

Tvorba GPX

Protože při tvorbě GPX je potřeba dodržet některá pravidla, lze na serveru zveřejnit jen GPX soubory vytvořené tímto skriptem.

Aby nedocházelo ke konfliktům a problémům při zpracování, musejí autoři GPX souborů navíc dodržet některá pravidla pro jejich tvorbu. Z toho důvodu je přístup k funkcím pro tvorbu GPX souborů a jejich nahrání na server chráněn a je třeba skript do takového režimu nastavit.

Plugin umožňuje:

  1. pomocí API vyhledat na originálním serveru série kolem zadaných souřadnic nebo ve vybrané oblasti
  2. z nalezených sérií vybrat jednu, přenést ji to formuláře pro tvorbu GPX souboru
  3. doplnit k sérii některé další vlastnosti (např. GC kód rodičovské keše) a případně upravit hodnoty získané přes API
  4. vytvořit GPX soubor s LAB kešemi v sérii
  5. importovat GPX do databáze GeoGetu
  6. nahrát GPX soubor na webový server a tím jej zpřístupnit všem

Načtené série Série připravená k exportu do GPX souboru

Pravidla pro tvorbu GPX souborů

Pro orientaci v GPX souborech jsou důležité:

  • GC kód rodičovské keše (viz dále Číslování sérií)
  • jméno série
    • musí být v celém souboru jedinečné. Jak plugin, tak server toto kontroluje. Pokud by byla vytvořena série se stejným jménem ale jiným GC kódem, bude systémem vyhodnocena jako série se změněnou rodičovskou keší
    • nesmí obsahovat znak / (lomítko) nebo ' (apostrof). Pokud jméno série od jejího autora tyto znaky, je třeba je nahradit nejakými jinými vhodnými znaky (-,; a podobně) nebo jméno nějak upravit
  • jméno Adventure LAB keše je tvořeno jménem série a jménem vlastní keše ve tvaru série/keš
  • popis série je společný pro všechny keše a je uložen v položce ShortDescription, popis jednotlivých keší je samostatně u každé uložen v položce LongDescription
  • před vytvořením GPX souboru by měl být vyžádán souhlas autora série
    • pokud autor (sekvenční) série nesouhlasí se zveřejněním GPX souboru, měl by GPX soubor obsahovat jen ty údaje, které jsou snadno zjistitelné z mobilní aplikace před odehráním
    • jen první keš série bude správně pojmenovaná, ostatní budou pojmenovány jen pořadovým číslem
    • pravděpodobně jen první keš série bude mít správné souřadnice, ostatní budou mít souřadnice shodné s tou první keší

Pro snadnější získání informací společných pro všechny keše série je možné načíst hodnoty z rodičovské keše tlačítkem Vlastnosti z GG.

V případě, že série už v databázi GeoGetu je, lze načíst celou sérii najednou pomocí tlačítka Celá série z GG a jen upravit příznaky, které z databáze získat nejde. To umožňuje snadné opravy a případně změnu rodičovské keše.

Pomocí modrých šipek vedle jména konkrétní keše lze měnit její pořadí v sérii. Tím se keš přesune v seznamu uvedeným směrem. Pořadí keší v sérii je důležité zejména u sekvenčních sérií.

Číslování LAB keší v sérii

Číslování keší v sérii je odvozeno od GC kódu rodičovské keše. K němu se přidá znak mínus a za něj pořadové číslo LAB keše v sérii. Toto číslo je převedené z desítkové číselné soustavy na třicetišestkovou (znaky 0-9,A-Z). Prozatím se snad se všemi sériemi vejdeme do jednoho znaku, ale plugin počítá i se dvěma znaky. To dává 1295 keší v jedné sérii.

Protože GeoGet musí mít GC kód jeko jedinečnou hodnotu v celé databázi, nastavá trochu problém v případě, že od jedné keše (typicky megaevent) je odvozeno několik sérií LAB keší. V tomto případě bude použito dvoznakové pořadové číslo, kde bude první znak A-Z a bude použit jako pořadové číslo série přiřazené ke stejné rodičovské keši.

Obecny tvar tedy je:

<GC_kód_rodičovské_keše>-[<písmeno_série>]<pořadí_v_sérii>

(Písmeno série nemusí mít nutně počátek v A a směřovat k Z, ale může být i opačně od Z k A.)

Příklady:

  • GCxxxxxx-0 … prvni labka v sérii
  • GCxxxxxx-A … 11. labka v sérii
  • GCxxxxxx-10 … 37. labka
  • GCxxxxxx-A0 … 1. labka v první sérii k této rodičovské keši (ale také 361. labka v sérii, kdyby byla jediná velká série)
  • GCxxxxxx-B1 … 2. labka v druhé sérii k této rodičovské keši

Zůstává tak:

  • jedinečnost kódu keše pro geogetí databázi
  • zachován rodičovský kód, z URL se dá odstranit snadno mínus a vše za ním
  • máme možnost odlišit série
  • není problém použit číslování i pro velké série, jen bude třeba si uvědomit, že písmeno v pořadovém čísle není číslem série, ale doplňuje vyčerpanou čiselnou řadu s prvním znakem 0-9

Stažení

Stáhnout aktuální verzi: labforgg-2.1.20.gip

Seznam dostupných verzí

FilenameLast modified
labforgg-2.1.20.gip (38.64 KiB, 2w ago, 44 downloads)2020/03/19 13:24
labforgg-1.3.12.gip (26.74 KiB, 1M ago, 83 downloads)2020/03/02 18:25

Seznam změn

2.1.20 (19.3.2020)

  • zásadní přepracování pluginu i webu, rozlišovacím údajem série je jedinečné číslo LabId, od něj je odvozena veškerá manipulace se sériemi

1.3.12 (2.3.2020, počet stažení: 83)

  • úvodní veřejná verze pluginu

:!: Zobrazit změny ve starších verzích

Skrýt změny ve starších verzích

user/skript/labforgg.txt · Last modified: 2020/03/19 10:25 by gord