Help:Extension:Kartographer/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. | ![]() |
Hlavní stránky nápovědy:
- Jak vytvářet mapy pomocí Kartographeru ve VisualEditoru
- Úvod do Kartographeru ve wikitextu
- aktuálně: Kartographer - rozsáhlá stránka 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í


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".
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>
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"/>
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 |
|
text="Mapa New Yorku s vyznačením polohy Empire State Building" |
frameless | ignored |
|
frameless |
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
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.
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

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í. |
"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 |
---|---|---|
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
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.
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.
<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 |
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 |

<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>

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>
<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
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>
![]() | 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. |
![]() | 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
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ů
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
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).
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
- Úplná specifikace GeoJSON (RFC7946)
- GeoJSON na anglické Wikipedii
- Specifikace SimpleStyle používané programem Kartographer
- Sada ikon Maki používaná Kartographerem
Průvodci
Editory a nástroje
- GeoJSON.io editor
- Vector.rocks editor
- GeoJSON linter pro validate vašeho GeoJSON
Skupiny pro 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
<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ů
<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ů
<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čů
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
<maplink text="State of Colorado, outlined" zoom="7" > { "type": "ExternalData", "service": "geoshape", "ids": "Q1261" } </maplink>
Dotaz na Wikidata
<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
<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
<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
<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 |
---|---|---|
|
... text text text text text text ... | ... text text text ![]() |
|
Není podporováno: podívejte se na stránku T157502. | ... text text text ![]() |
|
... text text text text text text ... | ... text text text ![]() |
|
... text text text text text text ... | ... text text text ![]() |
|
... text text text text text text ... | ... text text text ![]() |
|
... text text text ![]() Nekonzistentní, viz T157640. |
... text text text ![]() |
|
Není podporováno: podívejte se na stránku T157502. | ... text text text ![]() |
|
... text text text ![]() |
... text text text ![]() |
|
... 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 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
<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
- Informace o implementaci v Kartographeru
- Special:MyLanguage/Help:VisualEditor/Maps - jak přidávat a upravovat mapy pomocí vizuálního editoru
- Používání Kartographeru s OpenStreetMap
- Maps project (2015-2017) - dokumentace o inženýrské činnosti Wikimedia od týmu Discovery v letech 2015 až 2017
- Map improvements 2018 - dokumentace o inženýrské činnosti Wikimedia od týmu Collaboration v roce 2018
- WMDE Geoinformation - dokumentace o inženýrské činnosti WMDE v letech 2021 až 2023, součást WMDE Technical Wishes.
- Průvodce pro vývojáře Kartographeru
- Podmínky používání Map
Poznámky pod čarou
- ↑ Geotvary jsou dostupné prostřednictvím služby nebo vlastnosti geoshape (P3896)