Help:Extension:Kartographer/en

This page documents how to use the 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 GeoJSON editor. Kartographer supports the simplestyle specification with Maki icons (Licensed under Creative Commons Zero).

== to   creates a link to a full screen map:

also accepts an extra parameter "text" to specify link text instead of the coordinates:

The  tag may contain the same geojson as.

== creates a link that shows a full screen map when clicked. The link text can be set with the  attribute. Without the  attribute, the word "map" will be shown. If a map uses GeoJSON, the  is set to the magic   or   value. In this case each  will be replaced with an incremental counter , and   with   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  will have different counter from.

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

could be expanded into

The attributes,  , and   control the location of the popup map. Use  for the link hint text. Use  for the text of the link (could be any valid wikitext markup). Use  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.