GeoGet

Complete geocaching solutions

User Tools

Site Tools


user:skript:stator:modules:stator-mappinboard

This is an old revision of the document!


Modul MapPinboard

Modul pro puntíkování nálezů do mapy. Nahrazuje původní modul MapCzDot a má mnohem širší možnosti nastavení. Především výběr území, které mapa zobrazuje, není omezen jen na předdefinované oblasti. Lze zobrazit nálezy na libovolném místě na světě. Vybrat lze také typ a podobu podkladové mapy i vlastnosti puntíků označujících nálezy. Kromě běžných bodů lze použít i teplotní profil, kdy se barva puntíků mění podle hustoty nálezů v daném místě mapy. To, co má nový modul MapPinboard s původním MapCzDot společné, je zdroj dat o vašich nálezech, který pro vykreslování puntíků používá. Pro tento účel se nahrávají na server Geocaching.cz pomocí stejnojmenného pluginu Geocaching.cz, který je standardní součástí distribuce GeoGetu.

Parametry modulu

Modul používá jako podklad statickou mapu, generovanou službou Google Static Map API. Tím jsou dány možnosti zobrazení a grafické provedení map. Základní funkce a možnosti nastavení modulu:

  • Oblast mapy - parametrem Area= lze zvolit některou z mnoha předdefinovaných oblastí. Od mapy Světa a kontinentů po mapy zemí, krajů a měst. V parametru Area= modulu MapPinboard se automaticky nabízejí všechny vámi odlovené země. Poslední možností v nabídce je oblast Custom. Díky vlastnostem generátoru a použití podkladu z globální světové mapy si lze vybrat zcela libovolné místo na Zeměkouli a opuntíkovat ho vlastními nálezy, jak je uvedeno dále. V každém případě platí, že puntíky nálezů nejsou omezeny zemí, krajem nebo podobně. Prostě, co se jako nález vejde do obdélníku oblasti, je zobrazeno puntíkem.
  • Styl mapy - parametrem MapStyle= vybereme předdefinovaný styl podkladové mapy. Výchozím stylem je světle šedá mapa, na které jsou puntíky dobře viditelné. Je možné volit i klasickou barevnou mapu Googlu se silnicemi nebo mapu satelitní. V nabídce je i mapa pouze s hranicemi států a/nebo hranicemi jejich vyšších správních celků. Poslední možností je nadefinovat si styl podle svých představ. V tom případě zvolíme MapStyle=CustomStyle a ve zvláštním parametru CustomStyle= pak ručně nastavíme parametry zobrazení jednotlivých mapových prvků.
  • Velikost puntíků - parametrem DotsSize= určíme velikost puntíků. Základním puntíkem je čtvereček o straně velikosti DotsSize a barvě podle nastavení na záložce Barvy. U puntíkování s teplotním profilem parametr DotsSize= určuje poloměr kolečka.
  • Zobrazení teplotního profilu - parametrem DotsHeatColor= zapneme zobrazování teplotního profilu. Místo čtverečků se nálezy zobrazují kruhovým puntíkem, jehož barva přechází od červené do žluté podle počtu nálezů v daném místě mapy.
  • Rozfázování nálezů po letech - parametrem YearlyDots= lze navolit, jestli se zobrazí pouze všechny nálezy, nebo se rozfázují po letech a doplní se panel na jejich přepínání. Roční vrstvy mohou být volitelně kumulativní (tj. zobrazí nálezy od počátku lovení do zvoleného roku), nebo může vrstva obsahovat jen nálezy zvoleného roku.
  • Vlastní oblast mapyExpert - pomocí parametrů CustomCenterPoint=, CustomZoom=, CustomWidth= a CustomHeight= určíme libovolnou vlastní oblast na mapě Světa, kterou chceme zobrazit s puntíky svých nálezů. Všechny parametry jsou v tomto případě povinné. CustomCenterPoint= jsou souřadnice středu mapy. CustomZoom= je “měřítko” Google mapy. Zoom=0 zobrazí celou mapu Světa, zoom=21 je maximální přiblížení mapy (pro terénní mapu je maximální zoom=15). Například Česká Republika se vejde do zoomu 7. Zvýšení zoomu o jeden stupeň zvětší měřítko 2x. Poslední dva parametry, CustomWidth= a CustomHeight= určují velikost podkladové bitmapy vrácené službou Googlu. Maximální rozměr je 640×640 pixelů. Podklad včetně puntíkování je modulem MapPinboard upraven na šířku podle velikosti prostoru ve statistice, kam je mapa ve finále vložena.
  • Vlastní styl mapyExpert - pomocí parametru CustomStyle= lze nastavit zcela vlastní způsob zobrazení podkladové mapy. Jak na to najdete v dokumentaci Google Static Map API v sekci Styled Maps. V zásadě přichází do úvahy změna typu mapy (roadmap, terrain, satellite, hybrid) a definice zobrazení jednotlivých mapových elementů. Nastavit lze viditelnost hlavních částí mapy a jejich elementů (volby visibility:on nebo visibility:off) a jejich barvu (v barevném prostoru HSL pomocí voleb hue:, saturation: a lightness:). Dobrým pomocníkem vám bude seznam hlavních částí mapy i všech jejich dílčích elementů.

    Do parametru CustomStyle= zapisujeme definice na každý řádek jednu a to bez oddělovacího znaku &. Například:
    maptype=hybrid
    style=feature:road|visibility:off
    style=element.labels|lightness:50

Příklady puntíkovaných map

V tabulce je pro představu pár ukázek z mnoha možností, jak může mapa vypadat. Jde opravdu jen o zlomek, protože už jen počet předdefinovaných oblastí spolu s parametry dávají neuvěřitelných 36 000 kombinací možného provedení puntíkované mapy.

ParametryKomentářVýsledná mapa
Area=Czech Republic
MapStyle=Grayed roadmap
DotsSize=2
DotsHeatColor=No
YearlyDots=All
Výchozí styl mapy ČR, červené puntíky 2x2px
Area=Czech Republic
MapStyle=Grayed roadmap
DotsSize=3
DotsHeatColor=Yes
YearlyDots=Years
Výchozí styl mapy ČR, teplotní profil nálezů, body s poloměrem 3px, rozfázování nálezů po jednotlivých letech (ukázka vpravo není interaktivní, vrstvy se v reálu přepínají tlačítkem s číslem roku, na ukázce jsou zobrazeny nálezy za samotný rok 2009).
Area=Ustecky (tag:CZ kraj)
MapStyle=Colored roadmap
DotsSize=5
DotsHeatColor=No
YearlyDots=All
Barevná mapa Ústeckého kraje, modré puntíky 5x5px
Area=Reunion
MapStyle=Grayed terrain
DotsSize=10
DotsHeatColor=No
YearlyDots=All
Terénní mapa Reunionu, největší možné puntíky 10x10px
Area=Middle Europe
MapStyle=Country borders
DotsSize=3
DotsHeatColor=No
YearlyDots=All
Střední Evropa, pouze hranice zemí
Area=World
MapStyle=Satellite
DotsSize=5
DotsHeatColor=No
YearlyDots=Cumulative
Satelitní mapa světa, žluté puntíky 5x5px, rozfázování nálezů po letech kumulativně, ve stylu “jak jsme dobývali svět” (ukázka vpravo není interaktivní, vrstvy se v reálu přepínají tlačítkem s číslem roku, na ukázce jsou zobrazeny nálezy od počátku lovení do roku 2015).
user/skript/stator/modules/stator-mappinboard.1449327736.txt.gz · Last modified: 2015/12/05 00:00 (external edit)