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 [https://www.mapbox.com/maki/</> Maki icons] (Licensed under Creative Commons Zero).

== </> 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> </>.

== </> 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 word "map" will be shown. If a map uses GeoJSON, the <tvar|markersymbol> </> 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  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  and   tags.

By default, the data inside the  or   tag is shown only for that one tag, and will not be shown anywhere else. If  or   specify the   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  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.