Help:Extension:Kartographer/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

Hlavní stránky nápovědy:

Rozšíření Kartographer umožňuje vytvářet interaktivní a statické mapy na wiki stránkách Wikimedie. Tato stránka je vyčerpávajícím odkazem na používání Kartographeru, včetně mnoha možností dostupných při použití značek <mapframe>, které vkládají mapy přímo do wiki stránek, a <maplink>, která vytváří odkazy na celostránkové interaktivní mapy a dotýká se prvků GeoJSON podporovaných Kartographerem. V dolní části stránky najdete nepřeberné množství příkladů.

Pokud potřebujete pomoc s Kartographerem a OpenStreetMapem, podívejte se na Help:Extension:Kartographer/OSM.

Jak používat Kartographer

Hledání stránek pomocí Kartographeru

Chcete-li najít stránky obsahující mapy Kartographeru, můžete hledat insource:mapframe.

Zobrazení článků v okolí

Snímek obrazovky mapy v zobrazení v plné velikosti. Pod obsahem mapy je tlačítko označené "Zobrazit články v okolí"
Tlačítko "Zobrazit články v okolí" v zobrazení mapy v plné velikosti
Snímek obrazovky mapy v zobrazení v plné velikosti. Některé kulaté značky jsou šedé a některé červené. Jedna kulatá značka zobrazuje vyskakovací okno s názvem, popisem a obrázkem.
Články v okolí a ručně přidané červené značky na mapě Kartographera

V režimu celé obrazovky můžete kliknout na tlačítko "Zobrazit blízké články" a zobrazit až 300 geograficky blízkých článků jako značky na mapě. Více špendlíků na stejném místě se při oddálení seskupuje do skupin a při přibližování se rozestupuje.

Jakmile pohnete mapou pomocí myši nebo přiblížíte a oddálíte, zobrazí se tlačítko "znovu načíst výsledky", které zobrazí další články v okolí.

Články v okolí jsou generovány z wiki, na které se právě nacházíte, s přihlédnutím k relevanci a blízkosti. Značky pro blízké předměty jsou kulaté. Jsou zobrazeny navíc ke všem ručně přidaným značkám, které mají jiný tvar.

Když kliknete na značku blízkého článku, zobrazí se vyskakovací okno s názvem, stručným popisem a obrázkem článku. Kliknutím na název přejdete na článek. Pokud je článek propojen se záznamem na Wikidata, vyskakovací okno zobrazí stručný popis z Wikidat. Chcete-li skrýt blízké články na mapě, klikněte znovu na tlačítko "Zobrazit blízké články".

Stránka projektu (anglicky)

Jak vytvářet mapy pomocí Kartographera

Základní syntaxe mapy

Chcete-li umístit mapu nebo odkaz na mapu přímo na stránku wiki, Kartographer nabízí dva tagy: <mapframe>, který vkládá mapu, která odkazuje na celoobrazovkovou interaktivní mapu, a <maplink>, který vytváří formátovaný text (s volitelnou značkou), který odkazuje na celoobrazovkovou interaktivní mapu.

Některé wikiny zabalují tyto značky do šablon, například Mapbox a Mapframe. Podívejte se na stránku nápovědy Kartografa vaší místní wiki, abyste zjistili, zda vaše wiki obsahuje šablony – nebo použijte značky přímo s tímto dokumentem jako průvodce.


<mapframe>

San Francisco

Značka <mapframe> vloží mapu na stránku wiki. Značka musí být buď prázdná nebo musí obsahovat GeoJSON. Další zdroje o psaní GeoJSON naleznete níže.

<mapframe text="San Francisco" width="350" height="350" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478" />


<maplink>

Značka <maplink> vytváří odkaz na mapu na celou obrazovku.

<maplink zoom="13" latitude="46.204391" longitude="6.143158"/>

Dává:

Její atributy a použití jsou v podstatě totožné s <mapframe>. Drobné rozdíly najdete níže.

Atributy

Níže naleznete seznam atributů pro <mapframe> a <maplink>.

Přísně vzato, jediné atributy, které jsou povinné (označené v tabulce * jsou width (šířka) a height (výška). Bez zadaného umístění vytvoří Kartographer na stránce mapu světa zadané velikosti v přiblížení.

Pokud není specifikováno zoom (přiblížení), Kartographer použije úroveň automatického přiblížení podle nejlepšího odhadu na základě polohy jakýchkoli značek nebo geotvarů na mapě.[1]

Použití v rámci každé značky: atribut="hodnota"

Attribut Hodnota Popis Příklady
width* pixely, "plné" Šířka rámečku mapy. "100%" also works as an alias for "full", but no other percentage. width=200, width="full"
height* pixely Výška rámečku mapy. height=300
zoom 0-19 Úroveň detailů mapy. Úroveň přiblížení 0 zobrazuje celou dostupnou mapu a úroveň přiblížení 19 zobrazuje nejvyšší úroveň detailů. Pokud není specifikováno přiblížení, Kartographer použije úroveň automatického přiblížení s nejlepším odhadem na základě polohy jakýchkoli přítomných značek nebo geotvarů. zoom=12
latitude, longitude desetinné stupně Pozice na zemi. Podrobné informace naleznete v tomto článku na wiki GIS. Pokud není specifikováno, Kartograf se pokusí odvodit středový bod z obsahu článku. latitude=46.204391 longitude=6.143158
align "left", "center", "right" Vodorovná poloha rámečku mapy na stránce. Výchozí hodnota této hodnoty je definována směrovostí jazyka stránky (RTL: "left"; LTR: "right"). S hodnotou „left“ nebo „right“ bude po mapě proudit další obsah wiki (viz odpovídající část Nápověda:Obrázky). align="right"
mapstyle "osm", "osm-intl" Styl podkladové mapy. Na Wikimedii jsou v současné době k dispozici pouze dva styly. Jeden se štítky (osm-intl) a jeden bez štítků (osm). mapstyle="osm"
lang kód jazyka, "local" Jazyk, který se má použít pro popisky a značky na mapě. "local" (místní) používá jazyk oblasti zobrazené na mapě. Poznámka: Ne všechny štítky jsou dostupné ve všech jazycích. Viz také #Languages_and_fallbacks. lang="es"
alt alternativní text Definuje alternativní text pro generovaný obrázek map. Funguje pouze pro wikiny s povoleným wgKartographerStaticMapframe. alt="Mapa ulic Manhattanu. Budova Empire State je označena uprostřed ostrova, jižně od Central Parku."
text wikitext
<mapframe>
Popisek pod rámečkem mapy. Způsobí, že atribut frameless bude ignorován, pokud je zadán.
<maplink>
Definuje text odkazu, na který se po kliknutí zobrazí mapa na celou obrazovku (Example). Pokud není zadán žádný vlastní text, text odkazu se zobrazí jako souřadnice středu mapy, např. .
text="Mapa New Yorku s vyznačením polohy Empire State Building"
frameless ignored
Pouze <mapframe>
Způsobí, že se vložená mapa nakreslí bez rámečku (ohraničení), podobně jako bezrámové obrázky. Ignorováno, pokud je nastaven atribut text, který vynutí vykreslení rámečku. Atribut je určen k použití bez hodnoty. Jakákoli hodnota bude ignorována. Zvláště si všimněte, že frameless="0" nebude fungovat podle očekávání. Místo toho musíte atribut smazat.
frameless
class "no-icon"
Pouze <maplink>
Odebere ikonu značky, která se běžně zobrazuje před textem odkazu, např. <maplink zoom="5" latitude="12.3" longitude="45.6" class="no-icon"/>.
class="no-icon"
* = required

Samozavírací značky

Když nepoužíváte GeoJSON, můžete použít <mapframe> a <maplink> jako self-closing, samostatné značky.

Samotné zavření:

<mapframe width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013" />

Přiložení GeoJSON:

<mapframe width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013">
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
}
</mapframe>


GeoJSON

Několik skupin automatických čítačů

Tagy <mapframe> a <maplink> mohou být prázdné nebo mohou obsahovat platný GeoJSON, aby bylo možné mapu opatřit značkami, nakreslit tvary a použít oblast masky.

Pro více podrobností o tomto širokém tématu si můžete přečíst tento užitečný úvod do GeoJSON a také úplnou specifikaci GeoJSON.

Níže uvedené příklady používají značku maplink. Jak již bylo zmíněno, GeoJSON použitý pro maplink může být použit pro mapframe beze změny.

Značky

Komplexní mapa - značka, odkaz na článek a obrázek

Mapy, které používají GeoJSON, mohou obsahovat jednu nebo více značek, které poukazují na zvláštní místa. Tyto značky se nastavují pomocí klíčových slov specifických pro značky na úrovni "properties" v GeoJSON.

Kartograf podporuje specifikaci simplestyle (jednoduchý styl) s ikonami Maki, které jsou dostupné pod licencí CC0. Viz úplný seznam podporovaných ikon.

<maplink text="Colorado State Capitol with marker icon" longitude="-104.98491" latitude="39.73939" zoom="17">
{
    "type": "Feature", "properties": 
        { 
            "marker-symbol": "town-hall", 
            "marker-color": "46ea5f", 
            "marker-size": "medium"
        }, 
    "geometry": 
        { 
            "type": "Point",
            "coordinates": [-104.98485267162323, 39.73928364167763] 
        }
}
</maplink>

Výsledek: Kapitol státu Colorado s ikonou značky

Automatická počítadla

Více značek na mapě lze seskupit a pojmenovat pomocí vzorů a počítadel. Níže je uveden souhrn atributů stylů pro položky umístěné na mapě pomocí GeoJSON. Další informace najdete na stránce specifikace jednoduchého stylu.

Attribut Hodnota Popis Příklad
marker-symbol název ikony, "‑number", "‑letter" Určuje, zda popisky postupných značek pokračují číslem (1, 2, 3...) nebo písmenem (A, B, C...).

Automatická řada "-čísel" je od 1 do 99 a písmena od A do Z. Pokud je zahrnut název skupiny jako "-number-eat", vygeneruje se více sérií.
Název ikony musí být z tohoto seznamu.

"marker-symbol": "museum"
marker-color hexadecimal color Tří- nebo šestimístná hexadecimální hodnota barvy pro každou značku. "marker-color": "#228b22"
marker-size small, medium, large Viz příklady každé velikosti. "marker-size": "medium"
title wikitext Po kliknutí na značku se zobrazí wikitext zadaný v hodnotě "title". "title": "[[:en:Downtown_Aquarium,_Denver|Downtown Aquarium Denver]]"

description wikitext Po kliknutí na značku se v hodnotě "popis" zobrazí wikitext nebo obrázek specifikovaný ve wikitextu. "description": "[[File:Denver-DTA.jpg|150x150px]]"

Bohatou škálu příkladů naleznete v sekci Příklady.

Tvary, linie a body

GeoJSON vám umožňuje přidávat čáry, geometrické oblasti a body jako anotace do vaší mapy. Můžete je definovat přímo nebo je importovat z externích databází.

Inline

GeoJSON umožňuje kreslit body (značky), jednoduché čáry a geometrické oblasti jako součást definice mapy. Následující příklady zahrnují atribut "geometrie" objektů GeoJSON uvnitř objektu Feature. Další informace naleznete v úplné specifikaci GeoJSON.

Objekt Souřadnice (délka/šířka) Funkce mapy Příklad GeoJSON Účinek
Point jediná pozice Značka
"geometry": {
"type": "Point",
"coordinates":
 [-122.629395, 45.505662]
}
LineString dvě nebo více pozic Čára spojující dva body
"geometry": {
"type": "LineString",
"coordinates":
[
 [-122.321777, 47.598526],
 [-122.629395, 45.505662]
]}
Polygon čtyři nebo více pozic, první a poslední identické Mnohoúhelník se stínovaným vnitřkem
"geometry": {
"type": "Polygon",
"coordinates": [
[
  [-122.365723, 48.209576],
  [-123.947754, 46.949528],
  [-122.695313, 44.776709],
  [-120.629883, 46.573148],
  [-122.365723, 48.209576]
]]}
Objekt Souřadnice (délka/šířka) Funkce mapy
MultiPoint více pozic více bodů (značky)
MultiLineString více sad pozic LineString více řádků
MultiPolygon více sad pozic Polygon více polygonů

Externí data

Geotvar Aljašky

GeoJSON umožňuje importovat geografické objekty z externích zdrojů pomocí atributu type s hodnotou ExternalData.

Mapy mohou čerpat ze známých geografických objektů pomocí jejich ID Wikidata (také prostřednictvím dotazů Wikidata SPARQL). Zdrojem pro externí polygony a čáry je databáze OpenStreetMap a souřadnice značek jsou získávány přímo z Wikidat.

Kromě toho mohou mapy odkazovat přímo na nezpracovaný GeoJSON uložený na Wikimedia Commons (soubory .map): podrobnosti viz Help:Map Data.

Objekty lze vykreslovat pomocí dat z externího zdroje těmito různými způsoby:

  • "service": "geopoint" - nakreslí značku.
  • "service": "geoline" - nakreslí jednoduchou čáru.
  • "service": "geoshape" - nakreslí mnohoúhelník se stínovaným vnitřkem.
  • "service": "geomask" - nakreslí mnohoúhelník a vystínuje vše mimo mnohoúhelník.
  • "service": "page" - cesta k souboru .map na Wikimedia Commons, který obsahuje platný GeoJSON.
Externí data nelze verzovat.
Prostřednictvím ID Wikidata
Attribut Hodnota
type ExternalData
service geopoint, geoline, geoshape, geomask
ids Jedno nebo více ID Wikidat oddělených čárkami

Polygony a čáry v databázi OpenStreetMap (OSM) jsou propojeny pomocí ID Wikidat. Wikidata ID jsou v komunitě OSM relativně nová. Počátkem roku 2025 existuje zhruba 3,6 milionu prvků s ID Wikidat. Můžete přidat své vlastní na https://www.openstreetmap.org/ – nezapomeňte přidat wikidata tag a odpovídající hodnotu QID. Polygon nebo linie jsou obvykle k dispozici Kartographeru do dvou dnů. Podrobné pokyny viz Help:Extension:Kartographer/OSM.

Značka se vykreslí, pokud má propojená položka Wikidata souřadnici P625.

Kombinovaná mapa Salcburku a Elixhausenu
Geobody pomocí QID Q667450 a Q15958518
<mapframe height="300" width="300" text="Combined map of Salzburg and Elixhausen">
{
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q34713,Q701153"
}
</mapframe>
<mapframe text="Geopoints using QIDs [[wikidata:Q667450|Q667450]] and [[wikidata:Q15958518|Q15958518]]" latitude="43.74" longitude="7.43" zoom="13" width="400" height="400">
{
  "type": "ExternalData",
  "service": "geopoint",
  "ids": "Q667450, Q15958518"
}
</mapframe>


Prostřednictvím dotazu na Wikidata
Attribut Hodnota
type ExternalData
service geopoint, geoline, geoshape, geomask
query Wikidata dotaz SPARQL
Názvy proměnných pro použití ve službě Wikidata Query Service
Proměnná Povoleno Poznámka Required?
?id geopoint, geoline, geoshape, geomask Požadované
?title geopoint, geoline, geoshape, geomask Dává nadpis ve vyskakovacím okně. Přijímá wikitext. Volitelné
?description geopoint, geoline, geoshape, geomask Další text ve vyskakovacím okně. Přijímá wikitext.
?geo geopoint Měly by to být souřadnice.
Proměnné markerů se chovají dle popisu v automatických počítadlech.
?marker_symbol geopoint
?marker_size geopoint
?marker_color geopoint
Proměnné výplně a styluahu se chovají, jak je popsáno ve stylingu tvarů.
?fill geoshape, geomask
?fill_opacity geoshape, geomask
?stroke geoline, geoshape, geomask
?stroke_opacity geoline, geoshape, geomask
?stroke_width geoline, geoshape, geomask
Pokud chcete, aby vyskakovací okna obsahovala obrázky nebo odkazy na příslušné články, můžete tyto informace načíst a přidat je do polí pro název nebo popis. Podrobnosti naleznete v následujících příkladech.
Guvernéři států USA s uvedením jejich stranické příslušnosti. (tvůrce dotazů)
<mapframe longitude="-110" latitude="52" zoom="3" width="400" height="300" text="Governors of US states with their party affiliation">
{
  "type": "ExternalData",
  "service": "geoshape",
  "query": "SELECT ?id ?head (SAMPLE(?img) as ?img_) (min(?partyId) as ?party) (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill) (concat('[[w:', substr(str(?link),31,400),  '{{!}}', ?headLabel, ']]') as ?title) (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 400), '{{!}}200px]]') as ?description) WHERE { ?id wdt:P31 wd:Q35657 . ?id wdt:P6 ?head . ?head wdt:P102 ?party . BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId) SERVICE wikibase:label { bd:serviceParam wikibase:language 'en' . ?head rdfs:label ?headLabel . ?id rdfs:label ?stateLabel . } OPTIONAL { ?head wdt:P18 ?img . } ?link schema:about ?head . ?link schema:isPartOf <https://en.wikipedia.org/> .} GROUP BY ?id ?head ?headLabel ?link ?stateLabel"
}
</mapframe>
Veřejné umění v Hoogvliet, Rotterdam. (tvůrce dotazů)

Místo ID položky Wikidat může mapa také odvozovat data z dotazu Wikidat ve SPARQL. (Dotazy SPARQL můžete vytvářet pomocí Tvůrce dotazů.)

<mapframe text="Public art in Hoogvliet, Rotterdam" latitude="51.86" longitude="4.36" zoom="13" width="400" height="400">
{
  "type": "ExternalData",
  "service": "geopoint",
  "query": "SELECT DISTINCT ?id ?geo (?idLabel as ?title) (if(BOUND(?image), concat(?typeLabel, '\\n', '[[File:', substr(str(?image), 52, 400), '{{!}}200px]]'), ?typeLabel) as ?description) (if(?type = wd:Q860861, '#800000', if(?type = wd:Q245117, '#000080', '#008000')) as ?marker_color) WHERE { ?id wdt:P136 wd:Q557141; wdt:P625 ?geo; wdt:P276* wd:Q2103147; wdt:P31 ?type. OPTIONAL {?id wdt:P18 ?image}. SERVICE wikibase:label { bd:serviceParam wikibase:language 'en, nl'. ?id rdfs:label ?idLabel. ?type rdfs:label ?typeLabel} .} ORDER BY ?id"
}
</mapframe>
Hradiska v Baskicku s obrázkem, velikostí a barvou
<mapframe width="400" height="300" text="Hillforts in the Basque Country, with image, size and color">
{
  "type": "ExternalData",
  "service": "geopoint",
  "marker-size": "small",
  "query": "SELECT ?id ?geo ?idLabel ?img ?herriaLabel (?idLabel as ?title) (concat(?herriaLabel, '\\n', '[[File:', substr(str(?img), 52, 400), '{{!}}200px]]') as ?description) ('small' as ?marker_size) ('#228b22' as ?marker_color) ('landmark-JP' as ?marker_symbol) WHERE {\n  SERVICE wikibase:label { bd:serviceParam wikibase:language \"eu,es,fr,en\". }\n  ?id wdt:P31 wd:Q744099.\n  ?id wdt:P131*/^wdt:P527 wd:Q47588;\n  wdt:P625 ?geo.\n  OPTIONAL { ?id wdt:P18 ?img .}\n  ?id wdt:P131 ?herria.\n}"
}
</mapframe>



Mapová data z Commons
New York City (externí mapy)

Mapová data v GeoJSON uložená na Commons lze vykreslit na mapě.

Attribut Hodnota
type ExternalData
service page
title cesta k souboru .map na Wikimedia Commons, který obsahuje platný GeoJSON.

Například: Neighbourhoods/New_York_City.map bude čerpat z této mapy.

Další informace: Help:Map Data
<mapframe width="300" height="400">
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>
Pozor! Pozor: Zavaděč map aktuálně nepodporuje zřetězená volání ExternalData. Pokud je načten zdroj typu ExternalData, který sám závisí na odkazech ExternalData, načítání se nezdaří. Podívejte se na stránky T155927 a T193458.
Pozor! Pozor: Názvy souborů .map jsou omezeny na délku 400 znaků a velikost souboru 2 MiB. Mějte to na paměti při vytváření souborů pro tento účel ve Wikimedia Commons.


Vrstva masky
Mapa Salcburku s maskou

Maska je pouze tvar obrácený naruby, zadaný stejným způsobem, ale s vnější stranou tvaru stínovanou.

<mapframe align="right" height="420" width="420" latitude="47.7992" longitude="13.0482" zoom="11"  text="Map of Salzburg with mask">
{
  "type": "ExternalData",
  "service": "geomask",
  "ids": "Q34713",
  "properties": {
    "fill": "#555555",
    "fill-opacity": 0.5,
    "stroke": "#000000",
    "stroke-width": 1,
    "stroke-opacity": 1
  }
}
</mapframe>
Kombinování více datových typů

Objekty ExternalData, Feature, FeatureCollection můžete kombinovat ve stejném elementu <mapframe> nebo <maplink>, například pro zvýraznění prvků pomocí názvů a popisů nad objekty z externích zdrojů.

Mapová data z Commons lze kombinovat s jinými typy dat jejich seskupením do paralelních bloků GeoJSON. Různé kombinace viz #Smíšené typy.

Stylování tvarů

Mezistátní dálnice I-696

Kromě výše uvedeného stylu značek podporují čáry a oblasti tyto vlastnosti jednoduchého stylu:

Attribut Hodnota Popis
stroke hexadecimal color Barva čáry nebo obrysu.
stroke-width pixely Tloušťka čáry tvaru.
stroke-opacity 0.0-1.0 Definuje průhlednost čáry tvaru. Nastavení 1 kreslí plnou čáru. 0 je neviditelná. Vyšší hodnoty (blížící se 1) zobrazují méně pozadí skrz čáru.
fill hexadecimal color Barva použitá k vyplnění tvaru.
fill-opacity 0.0-1.0 Definuje průhlednost oblasti výplně. Nastavení 1 vykreslí neprůhlednou oblast uvnitř tvaru. 0 je neviditelná. Vyšší hodnoty (blížící se 1) zobrazují méně pozadí v oblasti výplně.


Překrývání

Prvky mapy, které se překrývají, se vykreslují v pořadí, v jakém se objevují v kódu. Pokud mapa obsahuje dvě linie, které se překrývají, linie definovaná první se zobrazí pod linií definovanou později. To platí pro všechny prvky definované v kódu, které se kreslí na mapě.

Příklady
Definování obdélníkových, žlutých a černých diagonál
zobrazit zdroj
<mapframe text="Defining respectively rectangle, yellow and black diagonals" width="500" height="270" longitude="79.030" latitude="-24.794" zoom="8" align="center">
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {"fill": "#ff0000","fill-opacity": 0.7,"stroke-width": 0},
"geometry": {
 "type": "Polygon",
 "coordinates": [
 [
   [77.926025390625, -25.150257104114733],
   [80.14251708984374, -25.150257104114733],
   [80.14251708984374, -24.43714786161562],
   [77.926025390625, -24.43714786161562],
   [77.926025390625, -25.150257104114733]
 ]
 ]
 }
 },
{
"type": "Feature",
"properties": {"stroke": "#fffa00","stroke-width": 5},
"geometry": {
 "type": "LineString",
 "coordinates": [
   [77.926025390625, -25.150257104114733],
   [80.14251708984374, -24.43714786161562]
 ]
 }
 },
{
"type": "Feature",
"properties": {"stroke": "#000000","stroke-width": 5},
"geometry": {
 "type": "LineString",
 "coordinates": [
   [77.926025390625, -24.43714786161562],
   [80.14251708984374, -25.150257104114733]
 ]
 }
 }
 ]
}
</mapframe>

Kód pro výše uvedenou mapu obsahuje tři prvky, z nichž všechny využívají funkcionalitu "feature" (funkce) GeoJSON. Prvním prvkem je "Polygon" – červený obdélník. Následují dva prvky "LineString". Žlutá čára (#fffa00) je definována jako první, takže se zobrazuje pod černou čarou (#000000). Všimněte si, že hierarchie použitá k vykreslování prvků platí bez ohledu na to, zda jsou data nezpracovaná GeoJSON, nebo pocházejí z ID Wikidat či datové stránky Commons.

Mapa níže mění pořadí oproti prvnímu příkladu – černá čára (#000000) je definována jako první a je tedy přesunuta na konec zásobníku, poté je definován obdélník (#ff0000) s neprůhledností, která způsobí, že černá čára bude tmavě červená, a poté je zde žlutá diagonála (#fffa00).

Definování černé diagonály, obdélníku a žluté diagonály
zobrazit zdroj
<mapframe text="Defining respectively black diagonal, rectangle, yellow diagonal" width="500" height="270" longitude="79.030" latitude="-24.794" zoom="8" align="center">
{
  "type": "FeatureCollection",
  "features": [
{
"type": "Feature",
"properties": {"stroke": "#000000","stroke-width": 5},
"geometry": {
 "type": "LineString",
 "coordinates": [
 [
 77.926025390625,
 -24.43714786161562
 ],
 [
 80.14251708984374,
 -25.150257104114733
 ]
 ]
 }
},
{
"type": "Feature",
"properties": {"fill": "#ff0000","fill-opacity": 0.7,"stroke-width": 0},
"geometry": {
 "type": "Polygon",
 "coordinates": [
  [
  [
  77.926025390625,
  -25.150257104114733
  ],
  [
  80.14251708984374,
  -25.150257104114733
  ],
  [
  80.14251708984374,
  -24.43714786161562
  ],
  [
  77.926025390625,
  -24.43714786161562
  ],
  [
  77.926025390625,
  -25.150257104114733
  ]
  ]
  ]
  }
},
{
"type": "Feature",
"properties": {"stroke": "#fffa00","stroke-width": 5},
"geometry": {
 "type": "LineString",
 "coordinates": [
 [
 77.926025390625,
 -25.150257104114733
 ],
 [
 80.14251708984374,
 -24.43714786161562
 ]
 ]
 }
 }
 ]
}
</mapframe>

Zdroje GeoJSON

Odkaz

Průvodci

Editory a nástroje

Skupiny pro Wikivoyage

Funkce skupin je dostupná pouze na Wikivoyage.

Projekt Wikivoyage potřebuje zobrazit mapy, jejichž data jsou definována jinde na stránce. Může být definováno více bodů zájmu (POI) s tagy <maplink>, které se všechny zobrazují na jedné společné mapě na okraji stránky. (Viz příklad s použitím města Salcburk.)

Seskupování umožňuje editorům sdílet data mezi více tagy <mapframe> a <maplink>.

Data uvnitř tagu <mapframe> nebo <maplink> se obvykle zobrazují pouze na mapě vytvořené tímto tagem a nikde jinde.

Ale na Wikivoyage, pokud tag <maplink> obsahuje atribut group="...", data uvnitř těchto tagů budou umístěna do pojmenované skupiny spolu se všemi ostatními daty se stejným názvem skupiny. Značky se stejným názvem skupiny se zobrazí na jedné mapě. Každá značka postupně přidává data do skupiny.

Každý tag <mapframe> na tagu Wikivoyage zobrazuje vloženou mapu zobrazující skupiny uvedené v daném tagu.

Mapa může také zobrazit další skupiny zadáním atributu show="...". Lze zadat více názvů skupin, oddělených čárkou. Název skupiny může obsahovat pouze malá písmena latinky. Tato mřížka znázorňuje data, která se zobrazí pro každou značku.

Příklad:

<maplink>                               -- shows 1
<maplink group='food'>                  -- shows   2   4       8   10
<maplink group='bar'  show='bar'>       -- shows     3           9
<maplink group='food' show='bar'>       -- shows   2 3 4       8 9 10
<maplink              show='bar'>       -- shows     3   5       9
<maplink              show='food,bar'>  -- shows   2 3 4   6   8 9 10
<mapframe>                              -- shows             7
<mapframe group='food'>                 -- shows   2   4       8   10
<mapframe group='bar'  show='bar'>      -- shows     3           9
<mapframe group='food' show='bar'>      -- shows   2 3 4       8 9 10
<mapframe              show='bar'>      -- shows     3           9    11
<mapframe              show='food,bar'> -- shows   2 3 4       8 9 10    12
Stránky Wikivoyage také někdy obalují tagy <mapframe> a <maplink> v šablonách. Consult Mapshape, Listing and See for a good starting place.

Jazyky a záložní jazyky

Kartografické mapy získávají své popisky z open-source mapovacího projektu OpenStreetMap (https://www.openstreetmap.org/). Ve výchozím nastavení se Kartographer snaží zobrazit popisky map v jazyce wiki, ve kterém je zobrazena vložená mapa. Pokud tento jazyk není k dispozici, mapa použije daný nakonfigurovaný záložní jazyk wiki a poté místní jazyk v oblasti mapy uvedené v mapě Kartographeru. Pokud žádný z nich není k dispozici, Kartographer nezobrazí žádný popisek.

Jazyk, který se má použít pro popisky, můžete určit pomocí atributu lang nastavením jeho hodnoty na požadovaný kód jazyka. Příklad: lang="ja" zobrazí popisky v japonštině, pokud jsou k dispozici.

Chcete-li použít jazyk místní pro danou oblast mapy, zadejte lang=local. Pro více informací o používání místního jazyka ve vašich popiscích a o vícejazyčných datech OpenStreetMap obecně si přečtěte tento příspěvek. Kartografické mapy získávají svá data, včetně popisků map ve všech dostupných jazycích, z open-source mapovacího projektu OpenStreetMap. Pokud mapa, kterou chcete zobrazit, nenabízí popisky v požadovaném jazyce, můžete je vždy přidat sami do OpenStreetMap. Všimněte si, že názvy zemí a měst jsou v OpenStreetMap čerpány z uzlů popisků, nikoli z dat připojených k hraničním vztahům. Chcete-li začít, podívejte se na Průvodce OpenStreetMap pro začátečníky a na tyto osvědčené postupy v oblasti pojmenovacích konvencí.

Příklady

Bez parametrů

Muzea v San Franciscu
<mapframe text="San Francisco museums" width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013">
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
  "properties": {
    "title": "[[w:Exploratorium|Exploratorium]]",
    "description": "[[File:Giant_Mirror_at_the_Exploratorium.jpeg|200px]]",
    "marker-symbol": "museum",
    "marker-size": "large",
    "marker-color": "0050d0"
  }
}
</mapframe>


Značky a čítače

Kapitol státu Colorado se značkou radnice, odkazem na článek a obrázkem

<maplink text="Colorado State Capitol with a town hall marker, article link and image" longitude="-104.98491" latitude="39.73939" zoom="17">
{
      "type": "Feature",
      "properties": { "marker-symbol": "town-hall", "marker-color": "46ea5f", "marker-size": "medium", "title": "[[w:Colorado_State_Capitol|Colorado State Capitol]]", "description": "[[File:Coloradocapitolhill2.JPG|150px]]"},
      "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }
}
</maplink>


Číslované značky

Kapitol státu Colorado s číselnou značkou

<maplink text="Colorado State Capitol with a number marker" longitude="-104.98491" latitude="39.73939" zoom="17">{ "type": "Feature", "properties": {  "marker-color": "228b22", "marker-symbol": "-number"}, "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }}</maplink>


Značky s písmeny

Kapitol státu Colorado s fixem na písmena

<maplink text="Colorado State Capitol with a letter marker" longitude="-104.98491" latitude="39.73939" zoom="17">{ "type": "Feature", "properties": {  "marker-color": "508e33", "marker-symbol": "-letter"}, "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }}</maplink>


Několik značek v kolekci prvků

Denver Amusements

<maplink text="Denver Amusements" longitude="-105.01247406005858" latitude="39.74956567318853" zoom="14"> {"type": "FeatureCollection", "features":  [{ "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.00768899917603, 39.74859230437501] }, "properties": { "title": "[[w:Pepsi_Center|Pepsi Center]]", "marker-color": "420617", "marker-symbol": "-letter-see", "marker-size":"small"} }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01238822937012, 39.7526011757416] }, "properties": { "title": "[[w:Downtown_Aquarium%2C_Denver|Downtown Aquarium Denver]]", "marker-color": "508e33", "marker-symbol": "-letter-see","marker-size":"medium", "description": "[[File:Denver-DTA.jpg|150px]]" } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01247406005858, 39.74956567318853] }, "properties": { "title": "[[w:Confluence_Park|Confluence Park]]", "marker-color": "0d2751", "marker-symbol": "-letter-see", "marker-size":"large" } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01646518707275, 39.74656303364532] }, "properties": { "title": "South Platte Bike Trail", "marker-color": "61b9e2", "marker-symbol": "-number-see", "marker-size":"medium" } },]}</maplink>


Skupiny automatických čítačů
Několik skupin automatických čítačů
zobrazit zdroj
<mapframe text="Several groups of automatic counters" width="350" height="350" zoom="13" longitude="-122.39902496337889" latitude="37.80151060070086">
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.41816520690917,
          37.79097260220947
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.40786552429199,
          37.799654055191525
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.40185737609865,
          37.796262984039544
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.38743782043457,
          37.80535070427755
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.38005638122557,
          37.795449103799726
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-letter",
        "marker-color": "208020"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.40941047668457,
          37.81850557172186
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-letter",
        "marker-color": "208020"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.40357398986815,
          37.81280993744834
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-letter",
        "marker-color": "208020"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.39842414855956,
          37.8071138637568
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number-bar",
        "marker-color": "f01080"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.41181373596191,
          37.78595317184089
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number-bar",
        "marker-color": "f01080"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.39542007446289,
          37.787674400057654
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number-bar",
        "marker-color": "f01080"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.38649368286131,
          37.78401144262929
        ]
      }
    }
  ]
}
</mapframe>


ExternalData

Wikidata QID

Stát Colorado, náčrtek

<maplink text="State of Colorado, outlined" zoom="7" > { "type": "ExternalData", "service": "geoshape", "ids": "Q1261" } </maplink>


Dotaz na Wikidata
Guvernéři států USA a jejich stranická příslušnost
<mapframe longitude="-110" latitude="52" zoom="3" width="500" height="500" text="Governors of US states with their party affiliation">
{
  "type": "ExternalData",
  "service": "geoshape",
  "query": "SELECT ?id ?head (SAMPLE(?img) as ?img_) (min(?partyId) as ?party) (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill) (concat('[[w:', substr(str(?link),31,500),  '{{!}}', ?headLabel, ']]') as ?title) (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 500), '{{!}}200px]]') as ?description) WHERE { ?id wdt:P31 wd:Q35657 . ?id wdt:P6 ?head . ?head wdt:P102 ?party . BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId) SERVICE wikibase:label { bd:serviceParam wikibase:language 'en' . ?head rdfs:label ?headLabel . ?id rdfs:label ?stateLabel . } OPTIONAL { ?head wdt:P18 ?img . } ?link schema:about ?head . ?link schema:isPartOf <https://en.wikipedia.org/> .} GROUP BY ?id ?head ?headLabel ?link ?stateLabel"
}
</mapframe>


Mapová data z Commons
<mapframe width="300" height="400">
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>


Smíšené typy
Městské hradby Caderousse (se smíšenými typy)
<mapframe text="Caderousse city wall" width="300" height="300" zoom="15" longitude="4.75600" latitude="44.10200">
[
  {
    "type": "ExternalData",
    "service": "geoshape",
    "ids": "Q13518258",
    "properties": {
      "stroke": "#ffb100",
      "stroke-width": 6,
    }
  },
  {
    "type": "Feature",
    "geometry": { "type": "Point", "coordinates": [4.75566, 44.104498] },
    "properties": {
      "title": "Porte de Castellan"
    }
  },
  {
    "type": "Feature",
    "geometry": { "type": "Point", "coordinates": [4.75829, 44.10258] },
    "properties": {
      "title": "Porte Léon Roche"
    }
  }
]
</mapframe>


Smíšené typy se značkami
Neighbourhoods/New York City (with markers)
<mapframe width="300" height="300" zoom="12" longitude="-73.965278" latitude="40.782222">
[
  {
    "type": "ExternalData",
    "service": "page",
    "title": "Neighbourhoods/New York City.map"
  },
  {
    "type": "ExternalData",
    "service": "geoshape",
    "ids": "Q160409",
    "properties": {
      "fill": "#07c63e", "title": "Central Park"
    }
  },
  {
    "type": "Feature",
    "properties": {"title": "Roosevelt Island", "marker-color": "f01080"},
    "geometry": {
      "type": "Point",
      "coordinates": [
        -73.94511222839355,
        40.76734665426719
      ]
    }
  }
]
</mapframe>


Smíšené typy s dotazem SPARQL
Železniční příručka a dotazy (SPARQL)
<mapframe width="300" height="300" text="Manual railway and queried stations">
[
{
"type": "ExternalData",
  "service": "geopoint",
  "properties": {
        "marker-symbol": "rail",
        "marker-color": "302060" },
  "query": "SELECT ?id ?geo ?idLabel (?idLabel as ?title)  WHERE { ?id wdt:P81 wd:Q1760190 ; wdt:P31 wd:Q2175765; wdt:P625 ?geo . SERVICE wikibase:label { bd:serviceParam wikibase:language 'sv'. } }"
},
{
  "type": "ExternalData",
  "service": "geoline",
  "properties": {
    "stroke": "#AA0000",
    "stroke-width": 3
  },
  "ids": "Q119890957, Q119891049"
}
]
</mapframe>


Možnosti zobrazování

Následující tabulka ukazuje, jak lze mapu s tagem <mapframe> formátovat pro zobrazení na wiki stránce. Tabulka obsahuje dva sloupce: První zobrazuje interaktivní mapu pomocí tagu <mapframe> a druhý zobrazuje vykreslení vzorového obrázku se stejnými možnostmi.

Možnosti Zobrazení <mapframe> Vykreslení obrázku Special:MyLanguage/Help:Images
  • Formát: frame
  • Přizpůsobení: undefined
... text text text
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: none
Není podporováno: podívejte se na stránku T157502. ... text text text
text text text ...
  • Format: frame
  • Alignment: left
... text text text
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: center
... text text text
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: right
... text text text
text text text ...
... text text text
text text text ...
  • Format: frameless
  • Alignment: undefined
... text text text text text text ...

Nekonzistentní, viz T157640.
... text text text text text text ...
  • Format: frameless
  • Alignment: none
Není podporováno: podívejte se na stránku T157502. ... text text text
text text text ...
  • Format: frameless
  • Alignment: left
... text text text text text text ... ... text text text
text text text ...
  • Format: frameless
  • Alignment: center
... text text text text text text ... ... text text text
text text text ...
  • Format: frameless
  • Alignment: right
... text text text text text text ... ... text text text
text text text ...

Použijte width="full", aby mapa zabírala celou šířku stránky.

<mapframe width="full" height="200" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478"></mapframe>
Obrázek na celou šířku s rámečkem (výchozí)

Obrázek v plné šířce bez rámečku (a bez textu):

<mapframe width="full" height="200" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478" frameless></mapframe>

Způsoby

Mezistátní dálnice I-696 (styl)
<mapframe text="Interstate Highway I-696" width="300" height="300" longitude="-83.2297" latitude="42.4883" zoom="9">
{
  "type": "ExternalData",
  "service": "geoline",
  "ids": "Q2108",
  "properties": {
    "title": "Highway I-696",
    "description": "[[File:I-696 near M-10 in 1988.jpg|200px]]",
    "stroke": "#ffb100",
    "stroke-width": 8
  }
}
</mapframe>


Související odkazy

Poznámky pod čarou

  1. Geotvary jsou dostupné prostřednictvím služby nebo vlastnosti geoshape (P3896)
Category:Extension help/cs#Kartographer Category:Mapping/cs
Category:Extension help/cs Category:Mapping/cs Category:Pages using the Kartographer extension