Help:Extension:Kartographer

This page documents how to use the kartographer>Extension:Kartographer|Kartographer extension and its   and   tags.

Getting started


This code will insert a simple interactive map (like what you see on the right), with the ability to maximize it by either double-clicking the map or clicking the icon in the right corner.

You may use the   parameter to override default alignment to left, right, or center.

  usage
 { "type": "Feature", "geometry": { "type":"Point", "coordinates":[-122.3988, 37.8013] }, "properties": { "title": "Exploratorium", "description": "", "marker-symbol": "museum", "marker-size": "large", "marker-color": "0050d0" } }

The content of the   tag has to be either empty or a valid GeoJSON with styling, as produced by a [http://geojson.io/#map=15/37.7977/-122.4057 GeoJSON editor]. Kartographer supports the [https://github.com/mapbox/simplestyle-spec/tree/master/1.1.0</> simplestyle specification] with [<tvar|maki>https://www.mapbox.com/maki/</> Maki icons] (Licensed under Creative Commons Zero).

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:
 * To add a caption, use the  attribute.

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

== </> to <tvar|maplink> </> creates a link to a full screen map:

<tvar|maplink> </> also accepts an extra parameter "text" to specify link text instead of the coordinates:

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

== <tvar|maplink> </> creates a link that shows a full screen map when clicked. The link text can be set with the <tvar|text> </> attribute. Without this attribute, the coordinates will be shown (example: </> is set to the magic <tvar|minusnumber> </> or <tvar|minusletter> </> value. In this case each <tvar|minusnumber2> </> will be replaced with an incremental counter <tvar|onetwothree> </>, and <tvar|minusletter2> </> with <tvar|az> </> 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 <tvar|numbermuseum> </> will have different counter from <tvar|numberbar> </>.

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

could be expanded into

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

Groups
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 <tvar|maplink> </> tags, and one common map on the side of the page that shows them all.

The grouping concept allows editors to share data between multiple <tvar|mapframe> </> and <tvar|maplink> </> tags.

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

If <tvar|mapframe> </> or <tvar|maplink> </> specify the <tvar|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 <tvar|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.