Segítség:Kiterjesztés:Kartographer

Megjegyzés: Amikor szerkeszted ezt a lapot, beleegyezel a szerkesztésed CC0 alatti közzétételébe. Lásd a Public Domain Help Pages lapot további információkért. Edit · Translate

Ez az oldal dokumentálja, hogy hogyan használja a Kartographer kiterjesztést és annak a <mapframe> (térképkeret) és a <maplink> (térképlink) címkéket.

Az első lépések

Ez a kód beilleszt egy egyszerű interaktív térképet (olyat, mint, amit a jobb oldalt is látsz), azzal a lehetőséggel, hogy kettős kattintásokkal maximalizálni lehessen a térképet, vagy ez elérhető a jobb sarokban szereplő ikonra történő kattintással is.

• On Wikivoyage and test2wiki, this embedded map is interactive. A single-click is used to pan the map; double-clicking (or clicking the icon in the right corner) opens a full-screen map, which is also interactive.
• On Wikipedia and other Wikimedia wikis, this embedded maps is static. Single-clicking opens a full-screen map, which is interactive.

<mapframe text="Downtown [[wikipedia:San Francisco|San Francisco]]" width=250 height=250 zoom=13 latitude=37.8013 longitude=-122.3988 />

The align parameter overrides the default alignment to left, right, or center. Ez a zoom (ráközelítés) funkció lehetővé teszi a ráközelítést 0 és 19-szeres érték között. A 0 a legtávolabbról mutatja az adott területet, míg a 19 a legjobban ráközelített nézet látható.

<mapframe> használata

The content of the <mapframe> tag has to be either empty or a valid GeoJSON with styling, as produced by a GeoJSON editor. Kartographer supports the simplestyle specification with Maki icons (Licensed under Creative Commons Zero). Help:Extension:Kartographer/Icons contains a full list of supported icons.

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

Frames

Frameless maps are good for insertion as part of a template, whereas framed maps are good for insertion directly into the page, either by hand or by using the visual editor.

• To insert a map without a frame, add the "frameless" attribute: <mapframe frameless ...>
• To add a caption, use the text="..." attribute.

Adding the text attribute automatically enables a frame, even if there is a frameless attribute.

<maplink>

A <mapframe> megváltoztatása <maplink>-re egy linket hoz létre a térkép teljes kijelzős változatához:

37°48′37″N 122°23′58″W

<maplink zoom="13" latitude="37.8103" longitude="-122.3995" />

Az <maplink> még elfogadja extra paraméterként a "szöveget", ahhoz, hogy specializálja a linkszöveget a koordináták helyett:

click me

<maplink text="click me" zoom="13" latitude="37.8103" longitude="-122.3995" />

The <maplink> tag may contain the same geojson as <mapframe>.

<maplink> and automata-számlálók

<maplink> creates a link that shows a full screen map when clicked. The link text can be set with the text attribute. Without this attribute, the coordinates will be shown (example: 12°18′0″N 45°36′0″E). If a map uses GeoJSON, the marker-symbol is set to the magic ‑number or ‑letter value. In this case each ‑number will be replaced with an incremental counter 1, 2, 3..., and ‑letter with A...Z values.

If GeoJSON has more than one counter, the value of the first one will be shown as the link text. Optionally, editors may add a suffix to have multiple counters on the page at the same time. This way ‑number‑museum will have different counter from ‑number‑bar.

It would make sense to use a distinct color for each counting group. All data added via <maplink> will also be shown in all maps inserted with <mapframe>, unless the group attribute is used.

{{see
| name=Exploratorium | url=http://www.exploratorium.edu/
| lat=37.8013 | long=-122.3988
| content=A great museum
}}

kibővíthető még

<maplink zoom=9 latitude=37.8013 longitude=-122.3988>
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
  "properties": {
    "title": "Exploratorium",
    "marker-color": "228b22",
    "marker-symbol": "-number-see"
  }
}
</maplink>

The attributes zoom, latitude, and longitude control the location of the popup map. Use text for the text of the link (could be any valid wikitext markup). Use group to add the contents of this tag to the named group (see below).

Markers

Complex map - marker, article link and image

Markers can be added to maps to denote a location. These features are added using the JSON format.

These examples use maplink. The formatting for mapframe is the same, except that latitude=, longitude=, and zoom= must be specified (otherwise the map on the saved page will be centered on northern Africa).

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

Eredmény: Colorado State Capital with marker icon

A kijelölők tartalmazhatnak még információkat például képeket és linkeket a cikkekhez.

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

Eredmények (a kijelölővel lép kapcsolatba, hogy meg lehessen nézni az eredményét): Colorado State Capital with a town hall marker, article link and image

Wikidata azonosítók az OSM (Open Street Map) adatai használhatóak határok kiemelésére a geoshape (földrajzi forma) szolgáltatással.

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

Eredmény: State of Colorado, outlined

A Wikidata azonosítók használhatóak arra is, hogy a térkép egy adott kiválasztott régióját elrejtsék.

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

Eredmény: State of Colorado, highlighted

A kijelölőket meg lehet számozni.

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

Eredmény: Colorado State Capital with a number marker

A kijelölők (markerek) használhatnak betűket is.

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

Eredmény: Colorado State Capital with a letter marker

Többféle térképkijelölés különböző méretekben történő használatával egy kiemelt gyűjtemény is létrehozható.

<maplink text="Denver Amusements" latitude="39.74956567318853" longitude="-105.01247406005858" zoom="14"> {"type": "FeatureCollection", "features":  [{ "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.00768899917603, 39.74859230437501] }, "properties": { "title": "[[wikipedia: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": "[[wikipedia: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": "[[wikipedia: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>

Eredmény: Denver Amusements

Adj hozzá különböző színű térképkijelölőket és különböző számlálókat.

<maplink text="Add groups of different colored markers and different 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 ] }}
  ] }</maplink>

Eredmény: Add groups of different colored markers and different counters

• Map markers can use any color that has a RBG value (a quick internet search of "rgb color picker" will show several options).
• Markers can be one of three different sizes: small, medium or large.
• GeoJSON that is created elsewhere can be copied (in accordance with licensing and copyright restrictions) and then pasted into maplink (for example)
• If you are creating maps on Wikivoyage, it might be a good idea to use Groups (see below).
• If you want to learn more about adding external data to your map, see the External data section.

Csoportok

A csoportok kiterjesztés csak a Wikivoyage-ban elérhető' (a VisualEditor csapat kezdeményezésére)

For use on the Wikivoyage project, there is a need to show a map whose data is defined somewhere else on the page. For example, there may be multiple points of interest (POI) defined with <maplink> tags, and one common map on the side of the page that shows them all.

A csoportosítási koncepció lehetővé teszi a szerkesztőknek, hogy adatokat osszanak meg többszörösen a <mapframe> és a <maplink> címkéi között.

By default, the data inside the <mapframe> or <maplink> tag is shown only for that one tag, and will not be shown anywhere else.

If <mapframe> or <maplink> specify the group="..." attribute, the data inside those tags will be placed into a named group, together with all the other data by the same group name. As a result, any tags with the same group name will show the same map data, and each tag may incrementally add data to the group.

A tag may also show other groups, regardless if it belongs to a group or not, by specifying the show="..." attribute. Comma-separated multiple group names may be specified. The group name may only contain lower case English letters. This matrix shows what data will be shown for each tag.

 1 <maplink>                               -- shows 1
 2 <maplink group='food'>                  -- shows   2   4       8   10
 3 <maplink group='bar'  show='bar'>       -- shows     3           9
 4 <maplink group='food' show='bar'>       -- shows   2 3 4       8 9 10
 5 <maplink              show='bar'>       -- shows     3   5       9
 6 <maplink              show='food,bar'>  -- shows   2 3 4   6   8 9 10
 7 <mapframe>                              -- shows             7
 8 <mapframe group='food'>                 -- shows   2   4       8   10
 9 <mapframe group='bar'  show='bar'>      -- shows     3           9
10 <mapframe group='food' show='bar'>      -- shows   2 3 4       8 9 10
11 <mapframe              show='bar'>      -- shows     3           9    11
12 <mapframe              show='food,bar'> -- shows   2 3 4       8 9 10    12

Külső adatok

In addition to drawing polygons using GeoJSON, you may also get outlines of the well known geographical objects by their Wikidata ID if they are marked as such in the OpenStreetMap database. For example, the Wikidata item for Alaska is Q797, and we can draw it on a map by using the "external data" reference. More than one ID may be specified separated by a comma. To create a mask over the areas of interest, use the "geoshape" service. To invert this and create a mask over everything else, use the "geomask" service.

Wikidata IDs are relatively new to the OSM community. There are about 1.3 million features with IDs. To add more, visit https://www.openstreetmap.org/ and add wikidata tag with the Q value (see Key:wikidata on OSM wiki for an easier way to do it). Az adat két napon belül elérhetővé válik a Kartographerben. Bővebb útmutatásért látogass el a $Segítség oldalra.

<mapframe text="A geoshape of Alaska" width=300 height=300 zoom=3 latitude=64.01 longitude=-152.58>
{
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q797"
}
</mapframe>

GeoShapes a Wikidata Query-n keresztül.

While this helps with the simple use cases when the Wikidata ID is well known, sometimes you may want to get a list of IDs as a result of a Wikidata query. A SPARQL query gets a list of all US states in the ID column of the result, and geoshapes service adds the geometrical outlines for each state. All other columns in the SPARQL query result become values in the "properties" object. The "fill" column changes the color of the state. The "title" column shows state governor's name, and "description" has wiki markup to show the state name and the governor's picture. To edit this query, copy the query parameter after the "#" symbol at https://query.wikidata.org/#...:

<mapframe latitude="52" longitude="-110" 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('[[wikipedia:', 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>

Térképadatok a Commons-ból

További információk: Help:Map Data

Vigyázat:

The map loader does not currently support chained ExternalData calls. If a resource of type ExternalData is fetched that itself relies on ExternalData references, loading will fail. See task T155927 and task T193458.

A Commonsban tárolt térképadatok fel lehetnek tüntetve a térképen. Például: c:Data:Neighbourhoods/New York City.map:

<mapframe width=300 height=400 zoom=11 latitude=40.7920 longitude=-73.9751>
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>

Többszörös adattípusok kombinálása

You can combine ExternalData, Feature, and FeatureCollection together in the same <mapframe> or <maplink> element:

<mapframe text="Caderousse city wall" width="300" height="300" zoom="15" latitude="44.10200" longitude="4.75600">
[
  {
    "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>

A Commonsból származó térképadatok kombinálhatók más adattípusokkal:

<mapframe width="300" height="300" zoom="12" latitude="40.782222" longitude="-73.965278">
[
  {
    "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>

Stilizálás

Wikidata ID elemek stilizálása

Külső adatokért adj hozzá stílusokat és címeket, használva a properties (tulajdonságok) kulcsszót:

<mapframe text="Interstate Highway I-696" width="300" height="300" latitude="42.4883" longitude="-83.2297" zoom="9">
{
  "type": "ExternalData",
  "service": "geoline",
  "ids": "Q2108",
  "properties": {
    "title": "Highway I-696",
    "description": "[[File:I696-1988.JPG|200px]]",
    "stroke": "#ffb100",
    "stroke-width": 8
  }
}
</mapframe>

A legfőbb stilizáló kulcsok a következők: "stroke" (szín), "stroke-width" (szélesség), "stroke-opacity" (átlátszóság), "fill" (szín telítettsége), "fill-opacity" (átlátszóság telítettsége).

Egymást átfedő elemek

Azon térképelemek, amelyek egymást kitakarnák a térképen, abban a sorrendben fognak láthatóvá válni, amilyen sorrendben a kódba be lettek illesztve. Példának okáért: ha a térkép két olyan vonalat tartalmaz, amelyből az egyik kitakarná a másikat, akkor az először definiált vonal jelenik meg először, a második fölöttiként. A következő példák szemléltetik azt, hogy hogyan is jelenik meg mindez a térképeken:

The code for the map above includes three elements, all of which use GeoJSON's "feature" functionality. The first feature is a "Polygon" - the red rectangle. This is followed by two "LineString" features. The yellow line is defined first, so it appears beneath the black line. Note that the hierarchy used to draw elements applies regardless of whether the data is raw GeoJSON or comes from a Wikidata ID or Commons data page.

The map below changes the order from that of the first example: the black line is defined first and is thus moved to the bottom of the stack:

Hozzárendelési lehetőségek

The following table shows how a <mapframe> map can be formatted for display on a wiki page. The table contains two columns: the first shows an interactive map via the <mapframe> tag, and the second showing the rendering of an example image with the same options.

Opciók	<mapframe> hozzárendelése	Kép hozzárendelése
Format: frame Alignment: undefined	... text text text text text text ...	... text text text text text text ...
Format: frame Alignment: none	Not supported, see task 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 ... Inconsistent, see task T157640.	... text text text text text text ...
Format: frameless Alignment: none	Not supported, see task 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 ...

Térképek nyelve

A 2018 májusi állapot szerint a térképcímkék megpróbálják annak a wikinek a nyelvét használni, ahol a beágyazott térképek megjelennek. Amennyiben az a nyelv nem elérhető, akkor a térkép azt a nyelvet fogja megjeleníteni, amely fallback(s) in MediaWiki konfigurálva van az adott nyelvvel. Ha az adott címke nem elérhető egyéb konfigurált nyelveken, akkor az angol nyelvű szöveg jelenik meg automatikusan. Végül, ha nem érhető el egyetlen nyelv sem, akkor a térképen megjelenő címkék azon a nyelven jelennek meg, amely a térkép által megjelenített területen használatban van.

1. Look for value in the requested language
2. Look for value in a language (or languages) that are specifically defined as fallback languages
3. Look for a transliterated value
4. Look for label in the local language
5. If no value is found, display no label.

You can specify the language to use for labels by adding the lang= followed by the desired language code. e.g. lang="ja" to display labels in Japanese (if available).

<maplink text="Brussels, Belgium" width="250" height="250" zoom=13 latitude=50.85 longitude=4.35 lang="ja"/>

Eredmény: Brussels, Belgium

If you wish to use the language local to an area you can use lang=local. This shows map labels in the languages of the area mapped (essentially opting out of internationalization). This post gives more guidance about when, and why, you might wish to user lang="local"—and generally explains how OpenStreetMap multilingual data works.

Without the lang= attribute, maps will display in the language of the wiki in which they appear.

Map language fallbacks

Initially these fallbacks follow those found in MediaWiki. The language fallbacks for Maps are stored in fallbacks.json and can be made different than the MediaWiki settings. Individual Wikimedia projects can request a change to this fallback process in Phabricator. More Technical information can be found in T192701.

Maps use map data, including map label data for all languages, from the open-source mapping project OpenStreetMap. If the map you want to display doesn’t offer labels in the desired language, you can add labels in that language by adding them to OpenStreetMap. To get you started, there is an OpenStreetMap Beginners’ Guide, and guidance about naming conventions.

A community can decide to change its language fallbacks

Read all about changing your language's fallbacks on the Map Improvements project page.

Lásd még

• Terms of Use for Maps
• Help:VisualEditor/Maps - How to add and edit maps with the visual editor
• Az Open Street Maps elemek információinak használata a térképeken
• Maps project (2015-2017) - Documentation on the Wikimedia engineering activity from the Discovery team from 2015 to 2017
• Map improvements 2018 - Documentation on the Wikimedia engineering activity from the Collaboration team in 2018
• Kartographer Developer guide