الگو:Maplink/توضیحات

This template adds a link, or frame, which will display map data – either from:

• data stored in GeoJSON format on Commons
• line/polygon features in OpenStreetMap.
• coordinates, either supplied or from Wikidata
• raw GeoJSON, preferably transcluded from another page

Note:

• GeoJSON files cannot currently be directly uploaded. Instead, on Commons, create a page that is in the Data: namespace and ends in .map – see mw:Help:Map Data for further information.
• To make OpenStreetMap (OSM) features available, add the Wikidata key to the OSM relation (and wait 1 or 2 days) – see mw:Help:Extension:Kartographer#External_data and mw:Help:Extension:Kartographer/OSM for further information.

Uses

This template is intended for linear or polygon features, including (but not limited to):

• Roads
• Rivers
• Subway or train lines
• Ship courses
• Flight paths
• Explorers journeys
• Animal habitats
• Countries and their subdvisions

and more... This template can also be used to display point features on a map, i.e. coordinates.

Usage

Basic usage

• Data page on Commons (e.g. Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):

  {{maplink|from=}} (specify .map data page in from=, excluding Data prefix)

• Raw GeoJSON data (e.g. {{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}):

  {{maplink|raw=}} (specify raw GeoJSON, preferably transcluded from a subpage of Wikipedia:Map data)

• Line of a border or a linear feature from OSM:

  {{maplink|type=line|id=}} (Wikidata id only required if another article's Wikidata page is to be used)

• Shape from OSM:

  {{maplink|type=shape|id=}} (Wikidata id only required if another article's Wikidata page is to be used)

• Inverted shape from OSM:

  {{maplink|type=shape-inverse|id=}} (Wikidata id only required if another article's Wikidata page is to be used)

• Point feature (coordinates):

  ...from Wikidata:
  {{maplink|type=point|id=}} (Wikidata id only required if another article's Wikidata page is to be used)

  ...from specified coordinates:
  {{maplink|type=point|coord=}} (specify coordinates using {{CoordM}} template)

• To show in a frame, add the parameter |frame=yes.

• Additional parameters are available to customise the displayed map.

Full parameter set – data page

{{maplink
|display=
|from=
|zoom=
|text=
|icon=
}}

Full parameter set – raw data

{{maplink
|display=
|raw= <!-- preferably {{Wikipedia:Map data/subpage}} -->
|zoom=
|text=
|icon=
}}

Full parameter set – geoline/geoshape

{{maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}

Full parameter set – point features/coordinates

{{maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Parameters

For overall display

display

How the template is displayed. Valid values are:

inline - Only displays the inline link (you can forego this, as it is the default)

title - Only displays the title link

inline,title - Displays the inline link as well as the title link

title,inline - Same as above

text

Text to display for the link (or caption if using mapframe); default is "Map"

icon

Set to "no" to turn off the icon that appears next to the link

zoom

Zoom level, from 1 to 18 (larger numbers zoom in further); default is automatically determined by the map

Mapframe parameters (only work with inline display)

frame

Set to "yes" to show a map frame instead of a link

plain

Set to "yes" to show just the map without the surrounding frame, and without a caption (text parameter will be ignored)

frame-align

Alignment with respect to the page: left, center, or right; default is right

frame-width

Width of the map frame, default is 300

frame-height

Height of the map frame, default is 200

frame-latitude

(or frame-lat)

Optional - alternate latitude coordinate for initial placement of map

frame-longitude

(or frame-lat)

Optional - alternate longitude coordinate for initial placement of map

Raw GeoJSON

raw

The raw GeoJSON, preferably transcluded from a subapge of Wikipedia:Map data

For each feature

Multiple features can be displayed on a single map. For each additional feature, add a sequential number to the end of the parameter name. For example, the second uses parameters like |type2=, |id2=, etc., the third feature |type3=, |id3=, etc., and so on.

type

Type of data. Valid values are:

line – a geoline feature from OSM (e.g. a road)

shape – a geoshape feature from OSM (e.g. a state or province)

shape-inverse – a geomask feature from OSM (the inverse of a geoshape - allows an unobstructed view of the map beneath)

data – a geoJSON data page on Commons (parameter is optional in this case)

point – a point feature (coordinates)

id

(or ids)

Wikidata id (Q-number) of the point feature, Wikidata id that the OSM line/shape feature is tagged with. Separate multiple ids with a comma. Defaults to the current page's Wikidata id (if |from= not set).

from

The JSON (.map) file from Commons to display (excluding the Data: prefix)

title

Title of the feature (for features from OSM), displayed when the feature is clicked on; default is the page title

description

Description of the feature (for features from OSM), displayed when the feature is clicked on; optional

stroke-color

(or stroke-colour)

Color code for the color used to draw the feature (for features from OSM); default is #ff0000 (red)

stroke-width

Width for the lines used to draw the feature (for features from OSM); default is 6

coord

Coordinates to display for a point feature. Use {{CoordM}} template to specify coordinates. If not set, coordinates will be retrieved from Wikidata.

marker

Name of Maki marker image to display at the point feature. See mw:Maps/Icons for options. Defaults to marker (plain marker) if not set.

marker-color

(or marker-colour)

Color code (Hex triplet) specifying marker background color. Default is 5E74F3 ( )

Examples using multiple features

{{Maplink|frame=yes
|type=shape|id=Q3495894|title=Shape|description=Description of shape
|type2=line|id2=Q1318331|title2=Line|description2=Description of line
|type3=point|coord3={{coordM|32|S|116|E}}|title3=Point|description3=Description of point
}}

{{Maplink|frame=yes|plain=yes|frame-width=250|frame-height=280|zoom=6|frame-lat=29.185|frame-long=76.225
|type=shape-inverse|id=Q1174|title=Haryana
|type2=point|id2=Q200663|stroke-width=3|title2=Faridabad
}}

Infobox example

Mitchell Freeway
Map of Perth's northern suburbs with Mitchell Freeway highlighted in red
نوع	آزادراه

{{Infobox Australian road
| location = {{maplink |type=line |frame=yes |plain=yes |frame-align=center |frame-lat=-31.8262 |frame-long=115.7877 |zoom=9}}
  ...  (other parameters omitted)  ...
}}

Things this template can't do

This template is designed to make it simple to insert a map into a page. It supports the most common types of usage, but some of the capabilities of the full <maplink> function are not available. Here are the things this template can't do:

• Directly style the fill color or the opacity level of fills or strokes (data from Commons will inherit the styling specified in the .map page)
• Use Wikidata queries to obtain information for the map

Use the full <maplink> or <mapframe> function if you need to do any of these things - see mw:Help:Extension:Kartographer for instructions.

Things this template can do

• Use a combination of data sources together (direct GeoJSON, external data from Wikimedia Commons and external data from OpenStreetMap)
• Apply different styles to different external data features from OpenStreetMap
• Include multiple links to external data from Wikimedia Commons

See also

• Template:Mapbox - a derivative of this template that puts the link inside a right-aligned box
• Template:Attached KML