Differences

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

--- user:navody:ggmap [2020/04/29 07:10] – [Seznam dostupných pluginů pro GgMapu] gord
+++ user:navody:ggmap [2021/07/06 10:58] (current) – mikrom
@@ Line 1: / Line 1: @@
 ====== GGmap - mapa keší ======
 {{ : 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**.
@@ Line 8: / Line 9: @@
 ===== Diskuze =====
-  * Diskuze o mapě keší se nachází na stránkách [[http://www.geocaching.cz/topic/32671-geoget-2108/|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ží? =====
 Ve zkratce se dá říct, že k __zobrazování keší z GeoGetu na mapě__.
@@ Line 22: / Line 25: @@
 ===== Ovládání mapy =====
 Mapa je automaticky spuštěna v jednom ze dvou režimů:
@@ Line 27: / Line 31: @@
   * zobrazení všech keší zobrazených v okně GeoGetu
-Pokud má být na mapě zobrazeno příliš keší, bude místo jednotlivých ikon zobrazena ztv. heat mapa.
+Pokud má být na mapě zobrazeno příliš keší, bude místo jednotlivých ikon zobrazena tzv. heat mapa.
 {{:user:navody:ggmap:heat.jpg?200|}}
@@ Line 63: / Line 67: @@
   * na spodním okraji lišty je copyright
+<WRAP group>
+<WRAP column 30>
+{{:user:navody:ggmap:tools_l.jpg?direct&28|}}
+</WRAP>
+<WRAP half column>
 Na levé straně je nástrojová lišta, která umožňuje:
-{{:user:navody:ggmap:tools_l.jpg?direct&28 |}}
   * změnu mapy, vypnutí zobrazování dat z databáze GeoGetu a doplnění překryvných vrstev (kolizní kruhy 161 m případně další vrstvy doplněné pluginy)
   * kreslení úsečky nebo lomené čáry
@@ Line 71: / Line 79: @@
   * kreslení kruhu
   * kreslení jednotlivých bodů
-  * úpravu nakreslených objektů a
+  * úpravu nakreslených objektů
+</WRAP>
+</WRAP>
 ===== Tipy =====
 ==== Tisk mapy ====
-FIXME
-/*
-  - v **Tools -> Resize** si zvolím //rozměr mapy pro tisk// na šířku nebo na výšku
-  - pomocí tlačítka {{:user:navody:bublina.png?direct|}} si zapnu generovaní popisků
-  - najedu mapou nad oblast, kterou chci vytisknout, a zmáčknu **Refresh**
-  - na mapě se mi nově vygenerují body, a u každého bude číslo (nebo GC kód). A pod mapou bude tabulka. Tam si nacvakám, jaké sloupce chci, a seřadím si tu tabulku podle jakých chci sloupců
-  - v prohlížeči dám **Tisk**. Pro tisk se všechna ta hejblátka na mapě automaticky schovají a vytiskne se opravdu jen ta mapa a tabulka
-*/
-==== Měření vzdáleností, kreslení do mapy ====
+  * v pravé nástrojové liště zvolíme **Settings -> Resize** a tam vybereme velikost a formát mapy podle požadovaného tisku
 FIXME
-/*
-Všechny následující úkony budou začínat i končit na stejných místech. Začátek bude vždy v pravém horním rohu mapy, kde si vyberete nástroj: {{:user:navody:kresleni.png?direct|}}
+==== Kreslení do mapy a měření vzdáleností, velikostí ploch ====
-  * **packa** pro posunování mapy
-  * **špičatá bublina** pro nový bod v mapě
+<WRAP group>
+<WRAP column 30>
+{{:user:navody:ggmap:tools_l.jpg?25}}
+</WRAP>
+<WRAP column>
+V levé nástrojové liště, kde si vyberete požadovaný nástroj:
   * **klikatá čára** pro kreslení čar, tras
-  * ostatní tři tlačítka pro kreslení tvarů na nich zobrazených (poslední je takový "mnohoúhelník od ruky")
+  * **polygon** pro kreslení obecných n-úhelníků
-{{ : user:navody:drawkomplet.png?direct&400|Možnosti kreslení do mapy}}
+  * **obdélník** pro kreslení čtverců a obdélníků
-**Končit budete pod tlačítkem Tools**, kde vyberete **záložku Draw**. Tam jsou všechny informace o veškerých nakreslených objektech. Také je zde můžete **smazat**, **upravit** či **zkopírovat** některé **údaje** po kliknutí na tužtičku, či kliknutím na barevný čtvereček **změnit jejich barvu**.
+  * **kruh** pro kreslení kruhů
+  * **špičatá bublina** pro nový bod v mapě
+</WRAP>
+</WRAP>
-  * **__Bod__** prostě nakliknete někam do mapy (kam se vám to hodí). V záložce Draw pak uvidíte jeho souřadnice, které lze přes tužtičku snadno upravit. Popelnicí ho smažete
+=== Seznam nakreslených objektů a jejich úprava ===
-  * **__Čáru__** nakreslí asi každý, ukončit ji můžete buď dvojklikem v místě posledního bodu, případně stačí na poslední bod kliknout opětovně pouze jednou. V tu chvíli přestanete malovat. V záložce Draw uvidíte **délku celé čáry**, po kliknutí na ikonu tužky můžete upravit souřadnice nakliknutých bodů
-    * **Některé body jsou "zašedlé"** - tyto body jsou vždy uprostřed přímky mezi naklikanými body. Pokud za ně zatáhnete, přidáte tak do přímky další bod
-  * **__Čtyřúhelník__** umí něco navíc. V záložce Draw uvidíte nejen jeho **rozměry**, ale také **obsah**. Po kliknutí na tužku můžete upravit **souřadnice pravého horního (SV) a levého dolního (JZ) rohu**. V mapě můžete tažením za zašedlé body změnit délku stran
-  * **__Kruh__** vám po nakreslení ukáže svůj **poloměr a souřadnice středu**. Obě hodnoty můžete změnit kliknutím na ikonu tužky. Tažením za jeho střed můžete kruh přemístit na mapě, tažením za okrajové body změníte jeho velikost
-  * **__Mnohoúhelník__** může mít tvar podle vašeho uvážení. Na záložce Draw můžete vidět ale pouze jeho **obsah**. Po kliknutí na tužku je možné upravit polohu jeho "rohů." Zašedlé body mají stejnou funkci jako u čáry
-<WRAP center round tip 80%>
+{{ :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:
+  * smazat jej kliknutím na ikonku popelnice
+  * změnit barvu kliknutím na barevný obdélníček
+  * textově upravit tvar nebo polohu kliknutím na ikonku s tužtičkou. V tom případě se zobrazí editační okno, se souřadnicemi jednotlivých bodů prvku, kde tyto souřadnice můžete upravovat. Pokud je okno se souřadnicemi pro vaši potřebu malé, můžete jej zvětšit potažením za jeho pravý spodní roh
+  * **měření** - zobrazený seznam obsahuje u každého z prvků také jeho velikost nebo plochu. Potřebujete-li tyto hodnoty, je seznam prvků vhodné místo k jejich získání
+{{ :user:navody:ggmap:edit_2.jpg?250|}}
+Druhou možností úprav je grafická úprava. V levé nástrojové liště klikněte na poslední ikonu s tužtičkou
+  * na každém z prvků pak budou malým čtverečkem označeny body
+  * čtvereček je buďto bílý nebo průhledný. Průhledný čtvereček označuje střed čáry a nelze s ním manipulovat. Pokud bílý čtvereček uchopíte myší, můžete jej posunout a tím změnit tvar prvku
+  * po dokončení úprav klikněte na tlačítko **Save**
+<WRAP center round tip>
 Pokud je tedy například řešením nějaké mysterky těžiště trojúhelníku mezi třemi body, je to s pomocí mapy keší otázka max. deseti minut a na metr přesně.
 </WRAP>
-<WRAP center round tip 80%>
-Pokud se vám zdá okénko pro úpravu souřadnice bodů příliš malé, stačí ho chytit za pravý dolní roh a roztáhnout. Funguje jak na textové pole, tak na celé okno. ;-)
-</WRAP>
-*/
 === Využití polygonu ===
-FIXME
-Pokud chcete [[user:navody:export|exportovat]] velice specifickou oblast, lze i k tomuto účelu snadno použít mapu keší. V jejím menu **Tools → Draw** si nakreslete libovolný polygon (prostě si obkreslete oblast, kterou chcete). Kliknutím na ikonku s tužtičkou vyvoláte okno s jednotlivými body polygonu, který lze následně kombinací Ctrl+A, Ctrl+C, Ctrl+V uložit do textového souboru, který 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 ====
 Pokud chcete **přesunout mapu o velký kus nebo na určité místo** a nechce se vám u toho tolik tahat myší, mám pro vás rychlý způsob.
@@ Line 125: / 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.
-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ší ====
+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.
 {{ :user:navody:cachemapnumbers.png?direct|}}
 === 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ě.
   - 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 138: / Line 162: @@
 Pokud chcete přidat či odebrat některý z nabízených sloupců tabulky, stačí použít tlačítka mezi mapou a tabulkou. Pro srovnání keší v tabulce stačí kliknout na záhlaví některého sloupce.
 </WRAP>
+*/
 ==== Další triky ====
-=== Kontrola kolizí ===
-{{ :user:navody:cachemapprotect.png?direct|}}
-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 zvýrazní oblast 161 metrů, kde podle pravidel nesmí žádná jiná keš být. Slouží k tomu tlačítko {{:user:navody:protections.png?direct|}} hned vedle tlačítka pro zobrazení popisků. Následně je třeba ještě použít tlačítko Refresh.
-=== Street View ===
+=== Změna mapy, souřadnice aktuální polohy myši ===
-/*
-Pokud použijete jako mapový podklad mapy od strejdy Googla, můžete využít i toho, že Cachemapa zvládá jeho Street View. Stačí v levém horním rohu **chytit myší žlutého panáčka** {{:user:navody:streetview.png?direct|}} a **přetáhnout na požadované místo**. To, jestli daným místem projelo snímací auto Googlu poznáte snadno - objeví se tam modrá čára. Pokud v místě čára není, nemá cenu panáčka používat - stejně byste nic neviděli.
-**Vypnout** Street View je možné **křížkem** v pravém horním rohu mapy.
+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ěna mapy, souřadnice aktuální polohy myši ===
-Změnit mapu je velmi snadné - v levém orní rohu stačí najet na položku Mapa a vybrat si, kterou mapu chcete. Výběr je opravdu velký.
-Pokud vás zajímá, jaké souřadnice má místo, kam právě ukazujete myší, stačí se podívat do levého dolního rohu mapy.
+Pokud vás zajímá, jaké souřadnice má místo, kam právě ukazujete myší, stačí se podívat do stavového řádku okna s mapou.
 <WRAP center round info>
@@ Line 160: / Line 176: @@
 </WRAP>
+=== Kontrola kolizí ===
-===== Tvorba pluginů pro mapu =====
+{{ :user:navody:ggmap:161m.jpg?250|}}
-Pluginy rozšiřují funkce mapy o další možnosti. Může to být např.
+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á.
-  * doplnění dalších map nebo překryvných vrstev
+Upozorňuji, že tyto kruhy se zobrazují až od měřítka 17 (vlevo dole je na mapě vyznačena velikost 300 metrů).
-  * změna vykreslovaných ikon
-  * úprava vzhledu
-  * doplnění filtrování
-  * a mnoho dalších funkcí, záleží jen na autorovi pluginu
-  * vascriptu a
-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.
+=== Street View ===
-Umístění souborů pluginů:
+FIXME
+/*
+Pokud použijete jako mapový podklad mapy od strejdy Googla, můžete využít i toho, že Cachemapa zvládá jeho Street View. Stačí v levém horním rohu **chytit myší žlutého panáčka** {{:user:navody:streetview.png?direct|}} a **přetáhnout na požadované místo**. To, jestli daným místem projelo snímací auto Googlu poznáte snadno - objeví se tam modrá čára. Pokud v místě čára není, nemá cenu panáčka používat - stejně byste nic neviděli.
-  * ''*.ggm.js'' a/nebo ''*.css'' jsou v adresáři ''DATADIR\ggmap\plugin''
+**Vypnout** Street View je možné **křížkem** v pravém horním rohu mapy.
-  * ''*.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''
+*/
-Plugin má jedinou povinnou funkci ''*_ggm_init()'', která zajistí 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.
-<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()''.
-</WRAP>
-Jednoduchá ukázková funkce může vypadat takto:
-<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.)
-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)|
-==== 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í ===
+==== Pluginy ====
-{{topic>ggmap_other}}
+Použití, tvorba a seznam pluginů je v [[user:navody:ggmap-pluginy|samostatném popisu]].