Help:Map data/cs

PD Poznámka: Úpravou této stránky souhlasíte s uvolněním vašeho příspěvku pod licencí CC0. Více informací získáte na stránce nápovědy veřejné domény. PD

Mapová data umožňují uživatelům ukládat data GeoJSON na wiki, podobně jako obrázky. Jiné wikiny mohou tato data použít k vykreslování přes mapy a k dalším úpravám map.

Chcete-li vytvořit nová mapová data, přejděte na Wikimedia Commons a vytvořte novou stránku v jmenném prostoru Data s příponou .map, například Data:Sandbox/Name/Example.map. Nebojte se experimentovat a vytvářejte stránky s předponou Sandbox/<uživatelské_jméno>/. Prozatím lze obsah stránky upravovat pouze v nezpracovaném formátu JSON. Doufáme, že nakonec bude k dispozici výkonný editor, který zjednoduší vytváření GeoJSON souborů (můžete povolit gadget KartoEditor pro jejich přímou úpravu nebo použít [webovou stránku http://geojson.io geoJSON] a poté zkopírovat data GeoJSON).

Licencování dat

Všechna data v jmenném prostoru Data: musí být licencována pod jednou z následujících licencí:

  • CC0-1.0
  • CC-BY verze: CC-BY-1.0, CC-BY-2.0, CC-BY-2.5, CC-BY-3.0, CC-BY-4.0, CC-BY-4.0+
  • CC-BY-SA verze: CC-BY-SA-1.0, CC-BY-SA-2.0, CC-BY-SA-2.5, CC-BY-SA-3.0, CC-BY-SA-4.0, CC-BY-SA-4.0+
  • ODbL-1.0

Výchozí licence je prázdný řetězec (např. neplatná licence) a když se uživatel pokusí uložit stránku s neplatnou licencí, bude upozorněn na povolené licence.

Pole nejvyšší úrovně

Data mapy mají několik povinných a volitelných prvků nejvyšší úrovně:

Název Povinné? Popis
licensePožadované Vždy nastavte jednu z povolených řetězcových hodnot, např. "CC0-1.0". (Viz #Licence dat.)
descriptionVolitelné Nastaveno na lokalizovanou řetězcovou hodnotu – objekt s alespoň jedním párem klíč-hodnota, kde klíč je kód jazyka (např. "en") a hodnota je popisný řetězec.
sourcesVolitelné Hodnota řetězce wiki značek, která popisuje zdroj mapových dat.
zoomVolitelné Celé číslo mezi 0 a 18. Tato hodnota se používá pouze pro zobrazení mapy na samostatné stránce, nikoli při jejím zahrnutí do článků.
latitude
longitude
Volitelné Střed mapy při jejím zobrazení na samostatné stránce, nikoli při jejím zahrnutí do článků.
dataPožadované Platný obsah GeoJSON. Podle specifikace GeoJSON lze pro každý objekt Feature nastavit pole properties. Data mapy budou používat všechny vlastnosti Simple Style, například title, description, fill a další. Pole title, description mohou být navíc buď řetězce, nebo lokalizované řetězcové objekty (podobně jako lokalizovaný typ Special:MyLanguage/Help:Tabular Data#Data types v tabulkových datech). Díky tomu se stejná mapová data mohou zobrazovat odlišně v závislosti na jazyce uživatele.
mediawikiCategoriesVolitelné Seznam kategorií pro stránku s mapovými daty.
"mediawikiCategories": [
        {
            "name": "Example category",
            "sort": "Its sortkey"
        },
        {
            "name": "Another category"
        }
    ]

Použití

Pro zobrazení mapy spolu s vlastními mapovými daty definovanými na stránce .map použijte tagy <mapframe> a <maplink>. Za tímto účelem přidejte tento wiki kód (nebo podobný kód <maplink>, ale bez width a height) na libovolnou wiki stránku v libovolném projektu a zobrazí se obsah stránky Data:Sample.map z Commons. Obsah bude lokalizován na základě nastavení jazyka uživatelského rozhraní.

<mapframe width=500 height=350 zoom=11 latitude=40.8 longitude=-74>
{
  "type": "ExternalData",
  "service": "page",
  "title": "Sample.map"
}
</mapframe>

I když se nejedná o příliš běžný scénář použití, Lua skript na jakékoli wiki může získat mapová data voláním mw.ext.data.get("Example.map"). Funkce vrací data téměř ve stejném formátu jako původní JSON, s tím rozdílem, že všechny lokalizované řetězce budou převedeny na běžné řetězce a pole licence bude také obsahovat lokalizovaný název licence. Chcete-li získat data v jiném jazyce, předejte kód jazyka jako druhý parametr. Chcete-li získat data v původní, neupravené podobě, použijte jako kód jazyka "_".

Příklady

Jednoduchá mapa

<mapframe width=200 height=200 zoom=11>
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>

Mapa v infoboxu

|map={{maplink|frame=yes|plain=yes|frame-align=center|frame-width=290|frame-height=200|type=line|from=Neighbourhoods/New York City.map}}
|map_custom=yes

Ukázková mapová data

{
    "license": "CC0-1.0",
    "description": { "en": "Manhattan Neighborhoods" },
    "sources": "http://example.com and [[Data]] page",
    "zoom": 11,
    "latitude": 40.8,
    "longitude": -74,
    "data": {
        "type": "FeatureCollection",
        "features": [
            {
                "type": "Feature",
                "properties": {
                    "title": {"en":"Alphabet City", "ru":"Алфабет-сити"}
                },
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [[
                    	[-73.980356454849,40.730425548938],
    ...

kompletní kód mapy

Omezení a triky

  • Každá hodnota řetězce kromě "sources" nesmí být delší než 400 symbolů. Speciální znaky jako nové řádky \n a tabulátory \t nejsou povoleny.
  • Celková velikost stránky nesmí překročit 2 MB.
  • Načítání čar nebo tvarů pomocí ID Wikidat v datové stránce způsobí, že se mapa při jejím volání přes maplink nebo mapframe přeruší. Řešením je přidat ID přímo do kódu maplink nebo mapframe:
<mapframe width="500" height="500">
 [
  {
   "type": "ExternalData",
   "service": "geoshape",
   "ids": "Qxxxxx"
  },
  {
   "type": "ExternalData",
   "service": "page",
   "title": "Sample.map"
  }
 ]
</mapframe>

Zdroje jsou vykresleny v pořadí, v jakém jsou uvedeny v kódu – ve výše uvedeném příkladu se geotvar z Wikidat zobrazí pod komponentami z datové stránky. Toto by se stalo obráceně, pokud by byla datová stránka volána před ID Wikidat.

Související odkazy

Category:Help/cs Category:Extension help/cs Category:Mapping/cs
Category:Extension help/cs Category:Help/cs Category:Mapping/cs Category:Pages using the Kartographer extension