Help:Map data/cs
![]() |
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. | ![]() |
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 |
---|---|---|
license | Požadované | Vždy nastavte jednu z povolených řetězcových hodnot, např. "CC0-1.0" . (Viz #Licence dat.) |
description | Volitelné | 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. |
sources | Volitelné | Hodnota řetězce wiki značek, která popisuje zdroj mapových dat. |
zoom | Volitelné | 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ů. |
data | Pož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. |
mediawikiCategories | Volitelné | 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],
...
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
- geoshape (P3896) - vlastnost pro odkazování na stránky
.map
z související položky Wikidat - Wikidata:Map data
- Tabulární data - podobně strukturovaná tabulková data ve jmenném prostoru Data: na Commons.