GeoGet

Complete geocaching solutions

User Tools

Site Tools

You are here: start » user » navody » ggmap
Trace:
user:navody:ggmap

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
user:navody:ggmap [2020/05/06 10:12] – [Instalační a oginstalační script *.ggi.pas] gorduser:navody:ggmap [2021/07/06 10:58] (current) – mikrom
Line 1: Line 1:
 ====== GGmap - mapa keší ====== ====== GGmap - mapa keší ======
 +
 {{ : user:navody:ggmap:mapa_cela.jpg?direct&400|}} {{ : user:navody:ggmap:mapa_cela.jpg?direct&400|}}
 Mapa keší je samostatná html aplikace dodávaná spolu s GeoGetem. Běží ve vašem výchozím internetovém prohlížeči a pro svoji činnost vyžaduje připojení k internetu. Spustíte ji pomocí tlačítka {{:user:navody:ggmap:cachemapaico.png|}} na hlavní nástrojové liště GeoGetu nebo z menu **Seznam - Mapa kešek**.  Mapa keší je samostatná html aplikace dodávaná spolu s GeoGetem. Běží ve vašem výchozím internetovém prohlížeči a pro svoji činnost vyžaduje připojení k internetu. Spustíte ji pomocí tlačítka {{:user:navody:ggmap:cachemapaico.png|}} na hlavní nástrojové liště GeoGetu nebo z menu **Seznam - Mapa kešek**. 
Line 8: Line 9:
  
 ===== Diskuze ===== ===== Diskuze =====
 +
   * Diskuze o mapě keší se nachází na stránkách [[http://www.geocaching.cz/topic/32675-ggmap-mapa-s-pluginy/|geocaching.cz]].   * Diskuze o mapě keší se nachází na stránkách [[http://www.geocaching.cz/topic/32675-ggmap-mapa-s-pluginy/|geocaching.cz]].
  
 ===== K čemu slouží? ===== ===== K čemu slouží? =====
 +
 Ve zkratce se dá říct, že k __zobrazování keší z GeoGetu na mapě__. Ve zkratce se dá říct, že k __zobrazování keší z GeoGetu na mapě__.
  
Line 22: Line 25:
  
 ===== Ovládání mapy ===== ===== Ovládání mapy =====
 +
 Mapa je automaticky spuštěna v jednom ze dvou režimů: Mapa je automaticky spuštěna v jednom ze dvou režimů:
  
Line 80: Line 84:
  
 ===== Tipy ===== ===== Tipy =====
 +
 ==== Tisk mapy ==== ==== Tisk mapy ====
  
Line 85: Line 90:
  
 FIXME FIXME
 +
 ==== Kreslení do mapy a měření vzdáleností, velikostí ploch ==== ==== Kreslení do mapy a měření vzdáleností, velikostí ploch ====
 +
 <WRAP group> <WRAP group>
 <WRAP column 30> <WRAP column 30>
Line 102: Line 109:
  
 === Seznam nakreslených objektů a jejich úprava === === Seznam nakreslených objektů a jejich úprava ===
 +
 {{ :user:navody:ggmap:edit_1.jpg?250|}} {{ :user:navody:ggmap:edit_1.jpg?250|}}
 Seznam všech nakreslených objektů je vidět po kliknutí na 2. ikonu v pravé nástrojové liště. U každého objektu je pak možnost: Seznam všech nakreslených objektů je vidět po kliknutí na 2. ikonu v pravé nástrojové liště. U každého objektu je pak možnost:
Line 121: Line 129:
  
 === Využití polygonu === === Využití polygonu ===
 +
 Pokud chcete [[user:navody:export|exportovat]] velice specifickou oblast, lze i k tomuto účelu snadno použít mapu. Výše popsaným způsobem nakreslete polygon (prostě si obkreslete oblast, kterou chcete), kliknutím na ikonku s tužtičkou zobrazte seznam objektů a kliknutím na objekt polygonu zobrazíte okno s jednotlivými body polygonu. Tyto body lze kombinací Ctrl+A, Ctrl+C, Ctrl+V uložit do textového souboru, který např. uložíte do složky polygon v [[user:slozky#datovy_adresar|datovém adresáři]] GeoGetu. Více [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=15358&pid=212770#post_212770|na fóru]]. Pokud chcete [[user:navody:export|exportovat]] velice specifickou oblast, lze i k tomuto účelu snadno použít mapu. Výše popsaným způsobem nakreslete polygon (prostě si obkreslete oblast, kterou chcete), kliknutím na ikonku s tužtičkou zobrazte seznam objektů a kliknutím na objekt polygonu zobrazíte okno s jednotlivými body polygonu. Tyto body lze kombinací Ctrl+A, Ctrl+C, Ctrl+V uložit do textového souboru, který např. uložíte do složky polygon v [[user:slozky#datovy_adresar|datovém adresáři]] GeoGetu. Více [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=15358&pid=212770#post_212770|na fóru]].
 ==== Přesun mapy - rychlejší varianta ==== ==== Přesun mapy - rychlejší varianta ====
Line 135: Line 144:
 Mapa ve svém základu filtrovat keše neumí, protože autorovým záměrem bylo mít mapu co nejrychlejší a předpokládá, že si buďto vyberete do seznamu požadované body a zobrazíte je v mapě nebo že se budete orientovat na mapě se všemi kešemi. Mapa ve svém základu filtrovat keše neumí, protože autorovým záměrem bylo mít mapu co nejrychlejší a předpokládá, že si buďto vyberete do seznamu požadované body a zobrazíte je v mapě nebo že se budete orientovat na mapě se všemi kešemi.
  
-Možnosti filtrování mohou doplnit různé pluginy ... FIXME+Možnosti filtrování mohou [[user:navody:ggmap-pluginy#filtrovani_bodu|doplnit různé pluginy]].
  
 ==== Zobrazení popisků, tabulka keší ==== ==== Zobrazení popisků, tabulka keší ====
 +
 FIXME FIXME
 /* /*
 Ve výchozím nastavení nevidíte v mapě popisky keší a o jakou keš/waypoint se jedná, se dozvíte až po najetí na její ikonku. Přímo název keše vám mapa sice nezobrazí (některé příliš dlouhé názvy by se v mapě pěkně motaly), zato vám může ukázat GC kód keše, případně pro potřeby tabulky pro tisk všechny body očísluje a následně vypíše do tabulky pod mapou. Ve výchozím nastavení nevidíte v mapě popisky keší a o jakou keš/waypoint se jedná, se dozvíte až po najetí na její ikonku. Přímo název keše vám mapa sice nezobrazí (některé příliš dlouhé názvy by se v mapě pěkně motaly), zato vám může ukázat GC kód keše, případně pro potřeby tabulky pro tisk všechny body očísluje a následně vypíše do tabulky pod mapou.
 {{ :user:navody:cachemapnumbers.png?direct|}} {{ :user:navody:cachemapnumbers.png?direct|}}
 +
 === Jak na to? === === Jak na to? ===
 +
   - Nezáleží, zda už máte keše na mapě zobrazeny, či nikoliv. Dobré ale je si **nejdříve na mapě zobrazit oblast, kterou chcete**. To vám zajistí, že v tabulce budou uvedeny pouze keše, které právě vidíte na mapě.   - Nezáleží, zda už máte keše na mapě zobrazeny, či nikoliv. Dobré ale je si **nejdříve na mapě zobrazit oblast, kterou chcete**. To vám zajistí, že v tabulce budou uvedeny pouze keše, které právě vidíte na mapě.
   - Mezi tlačítkem Refresh a Tools klikněte na {{:user:navody:bublina.png?direct|}} - tím zapnete popisky v mapě. Pokud chcete **místo pořadových čísel GC kódy**, stačí jít do **Tools -> Settings** a zakliknout políčko "Use GC code in labels (instead of order numbers)".   - Mezi tlačítkem Refresh a Tools klikněte na {{:user:navody:bublina.png?direct|}} - tím zapnete popisky v mapě. Pokud chcete **místo pořadových čísel GC kódy**, stačí jít do **Tools -> Settings** a zakliknout políčko "Use GC code in labels (instead of order numbers)".
Line 151: Line 163:
 </WRAP> </WRAP>
 */ */
 +
 ==== Další triky ==== ==== Další triky ====
 +
 === Změna mapy, souřadnice aktuální polohy myši === === Změna mapy, souřadnice aktuální polohy myši ===
 +
 Změnit mapu je velmi snadné - v levém horním rohu stačí najet na ikonku vrstev a vybrat si, kterou mapu chcete. Výběr je opravdu velký. Změnit mapu je velmi snadné - v levém horním rohu stačí najet na ikonku vrstev a vybrat si, kterou mapu chcete. Výběr je opravdu velký.
  
Line 162: Line 177:
  
 === Kontrola kolizí === === Kontrola kolizí ===
 +
 {{ :user:navody:ggmap:161m.jpg?250|}} {{ :user:navody:ggmap:161m.jpg?250|}}
 Ať už zakládáte novou keš, či luštíte mysterku, může se vám hodit funkce, která kolem každé keše (přesněji každého fyzického bodu) zvýrazní oblast 161 metrů, kde podle pravidel nesmí žádná jiná keš být. Najeďte vlevo nahoře na ikonku seznamu map, kde pod čarou jsou zobrazeny použitelné překryvné vrstvy. Druhá vrstva "Circles! je to, co vás zajímá. Ať už zakládáte novou keš, či luštíte mysterku, může se vám hodit funkce, která kolem každé keše (přesněji každého fyzického bodu) zvýrazní oblast 161 metrů, kde podle pravidel nesmí žádná jiná keš být. Najeďte vlevo nahoře na ikonku seznamu map, kde pod čarou jsou zobrazeny použitelné překryvné vrstvy. Druhá vrstva "Circles! je to, co vás zajímá.
Line 168: Line 184:
  
 === Street View === === Street View ===
 +
 FIXME FIXME
 /* /*
Line 175: Line 192:
 */ */
  
 +==== Pluginy ====
  
-===== Tvorba pluginů pro mapu ===== +Použití, tvorba a seznam pluginů je v [[user:navody:ggmap-pluginy|samostatném popisu]].
-Pluginy rozšiřují funkce mapy o další možnosti. Může to být např.  +
- +
-  * doplnění dalších map nebo překryvných vrstev +
-  * změna vykreslovaných ikon +
-  * úprava vzhledu +
-  * doplnění filtrování +
-  * a mnoho dalších funkcí, záleží jen na autorovi pluginu +
-  * javascriptu a mohou být doplněny o další soubory (css, obrázky, ...) +
- +
-Pluginy jsou v souborech ''*.ggm.js'' a případně odpovídajících souborech ''*.css''. Vlastní plugin je napsán v javascriptu a aby bylo možné jej spravovat obvyklým způsobem jako ostatní pluginy do GeoGetu, je vhodné jej distribuovat v *.gip balíčku, který se postará o překopírování souborů do správných adresářů GeoGetu. +
- +
-**Umístění souborů pluginů:** +
- +
-  * ''*.meta.ini'' a ''*.ggi.pas'' jsou v adresáři ''DATADIR\script\GgMap'' (toto není nutné pro funkci pluginu, je doporučené pro přehlednost a údržbu pluginů) o správné umístění souborů z instalačního balíčku by se měl postarat instalační script ''*.ggi.pas'' +
-  * ''*.ggm.js'' a/nebo ''*.css'' jsou v adresáři ''DATADIR\ggmap\plugin'' +
-  * všechny ostatní soubory, které plugin potřebuje , jsou v adresáři ''DATADIR\ggmap\plugin\jméno_pluginu'' +
- +
-<WRAP center round important> +
-O přesun souborů do správných adresářů při instalaci pluginu a smazání nepotřebných souborů a adresářů při odinstalování souboru se musí postarat instalační script ''*.ggi.pas''. +
- +
-Pro správné zobrazení pluginu v seznamu pluginů GeoGetu je potřeba do souboru ''*.meta.ini'' doplnit parametr ''Parent=ggmap_plugin'' +
-</WRAP> +
- +
-==== Inicializace pluginu ==== +
- +
-Základem správné funkce pluginu je jeho správná inicializace. O tu se stará funkce ''*_ggm_init()'', což je jediná povinná funkce. Ta by měla zejména zajistit inicializaci pluginu, nastavení obslužných funkcí událostí, doplnění položek menu a dalších činností potřebných pro správnou funkci pluginu. Inicializací se v tomto případě rozumí zejména doplnění volání funkcí pluginu v tu správnou chvíli, tedy při nějaké události. (Ve vyjímečných případech, kdy inicializace není potřeba, bude tato funkce prázdná, ale **existovat musí**!) +
- +
-Aktuální seznam všech možných událostí je v souboru ''DATADIR\ggmap\plugin\README.txt'': +
- +
-|onload|inicializace UI| +
-|pointname|překlad typu bodu na jméno ikony| +
-|loadicons|změna nebo rozšíření sady ikon| +
-|filterpoint|filtrování ikon keší-bodů (vrací "true" k ignorování bodu)| +
-|filterwpt|filtrování ikon waypointů (vrací "true" k ignorování bodu)| +
-|onmap|po ukončení inicializace mapových objektů| +
-|onclear|vyčištění uživatelských dat vrstev před loadbbox| +
-|loadbbox|zavedení uživatelských dat v rámci BBox| +
-|pointhower|kurzor nad bodem (vrací "true" k ignorování standardní rutiny)| +
-|pointclick|kliknutí na bod (vrací "true" k ignorování standardní rutiny)| +
- +
-<WRAP center round important> +
-Pro správnou funkci pluginu je důležité, aby byla velikost písmen ve jménech souborů v adresáři ''DATADIR\ggmap\plugin'' stejná jako velikost písmen funkce ''*_ggm_init()''. +
- +
-Pokud plugin potřebuje ke správné činnosti svůj ''*.css'' soubor, musí ve své ''*_ggm_init()'' funkcí zajistit jeho načtení. +
-</WRAP> +
- +
-==== Instalační a odinstalační script *.ggi.pas ==== +
- +
-Instalační script je zodpovědný za přenos souborů pluginu do adresáře pluginů GgMapy a také za zmazání všech souborů pluginu (tedy i ''*.meta.ini'' a ''*.ggi.pas'') při odinstalování pluginu. +
- +
-Existuje univerzální instalační script, který se za při dodržení několika podmínek pro tvorbu balíčku a pojmenování souborů o vše postará a autor pluginu jej nemusí pracně tvořit. +
- +
-  * instalační adresář v ''*.gip'' souboru je ''GgMap/JmenoPluginu'', plugin je tedy nainstalován do ''DATADIR/script/GgMap/JmenoPluginu'' a o přenesení jednotlivých součástí do správných adresářů se již postará instalační script +
-  * všechny soubory a případně i další podadresáře jsou v tomto adresáři +
-  * soubor ''JmenoPluginu.meta.ini'' obsahuje položku ''Parent=ggmap_plugin'' +
-  * soubor ''JmenoPluginu.meta.ini'' obsahuje spuštění instalačního scriptu, v sekci ''[install]'' položka ''script=Ggmap\JmenoPluginu\JmenoPluginu.ggi.pas'' +
-  * soubor ''JmenoPluginu.meta.ini'' obsahuje spuštění odinstalačního scriptu, v sekci ''[uninstall]'' položka ''Ggmap\JmenoPluginu.ggi.pas='' (script je při instalaci přesunut o adresář výš) +
- +
- +
-FIXME +
- +
-==== Ukázky postupů v pluginu ==== +
- +
-Zde jsou uvedeny jednoduché ukázky základních operací. +
- +
-=== Doplnění mapy do seznamu map === +
- +
-<code javascript> +
-function cuzk_ggm_init() { +
-  ggmregister('onmap', cuzk_ggm_run); +
-}; +
-</code> +
- +
-Funkce v tomto případě obsahuje jediný řádek, který registruje funkci ''cuzk_ggm_run'' pro spuštění po inicializaci mapových objektů. (Tato konkrétní funkce zajistí doplnění jedné mapy a jedné překryvné vrstvy do menu map. Plugin ''cuzk'' je součástí instalace mapy.) +
- +
-=== Zavedení *.css souboru === +
- +
-*.css soubor je vždy v základním adresáři pluginů a má stejné jméno jako plugin. +
- +
-<code javascript> +
-function jmenoPluginu_ggm_init() { +
- loadcss('plugin/jmenoPluginu.css'); +
-} +
-</code> +
- +
-===== Seznam dostupných pluginů pro GgMapu ===== +
-=== Další mapy a/nebo překryvné vrstvy === +
-{{topic>ggmap_map}} +
- +
-=== Filtrování bodů === +
-{{topic>ggmap_filter}} +
- +
-=== Nové sady ikon bodů/keší === +
-{{topic>ggmap_icon}} +
- +
-=== Ostatní === +
-{{topic>ggmap_other}} +
user/navody/ggmap.1588752743.txt.gz · Last modified: 2020/05/06 10:12 by gord