 | Note: When you edit this page, you agree to release your contribution under theCC0. SeePublic Domain Help Pages for more info. | |
Map data allows users to storeGeoJSON data on wiki, similar to images.Other wikis may use this data to draw on top of the maps, together with other map customizations.
To create a new map data, go toWikimedia Commons, and create a new page in theData namespace with the.map suffix, such asData:Sandbox/Name/Example.map.Feel free to experiment by creating pages with theSandbox/<username>/ prefix.For now, page content can only be edited in the rawJSON format.Eventually, we hope there will be a powerful editor to simplify GeoJSON creation (you can enable theKartoEditor gadget to edit them directly or use thegeojson.io website and then copy the GeoJSON data).
All data in theData: namespace must licensed under one of the following licences:
The default license is empty string (e.g invalid license) and when a user tries to save page with invalid license, they will be notified of the allowed licenses.
Map data has several required and optional top-level elements:
| Name | Required? | Description |
|---|---|---|
license | Required | Always be set to one of the allowed string values, e.g."CC0-1.0". (See#Data licensing.) |
description | Optional | Set to an object with at least one key-value, where the key is a language code (e.g. "en"), and the value is a description string (plain text, no wiki markup). |
sources | Optional | A wiki markup string value that describes the source of the map data. |
zoom | Optional | An integer between 0 and 18. This value is only used for displaying map on its own page, not when including it in the articles. |
latitudelongitude | Optional | The center of the map when displaying it on its own page, not when including it in the articles. |
data | Required | The validGeoJSON content. Per GeoJSON specification,properties field may be set for everyFeature object. The map data will use all of theSimple Style properties, such astitle,description,fill, and others. Additionally, thetitle,description fields may be either strings or localized string objects (similar to thelocalized type in tabular data). This allows the same map data to appear differently depending on the user's language. |
mediawikiCategories | Optional | List of categories for the Map Data page."mediawikiCategories":[{"name":"Example category","sort":"Its sortkey"},{"name":"Another category"}] |
Use<mapframe> and<maplink> tags to show a map together with the custom map data defined in the.map page.For that, add this wiki markup (or similar<maplink> but without thewidth andheight parameters) to any wiki page in any project, and the content of theData:Sample.map page from Commons will be drawn.The content will be localized based on the user's interface language settings.
<mapframewidth=500height=350zoom=11latitude=40.8longitude=-74>{"type":"ExternalData","service":"page","title":"Sample.map"}</mapframe>
While not a very common usage scenario, a Lua script on any wiki can get map data by callingmw.ext.data.get("Example.map").The function returns data in almost the same format as the original JSON, except that all localized strings will be converted to regular strings, and the license field will also include a localized license name.To get the data in another language, pass language code as the second parameter.To get the data in the original, unmodified form, use "_" as the language code.
<mapframewidth=200height=200zoom=11>{"type":"ExternalData","service":"page","title":"Neighbourhoods/NewYorkCity.map"}</mapframe>
|map={{maplink|frame=yes|plain=yes|frame-align=center|frame-width=290|frame-height=200|type=line|from=Neighbourhoods/New York City.map}}|map_custom=yes{"license":"CC0-1.0","description":{"en":"Manhattan Neighborhoods"},"sources":"http://example.com and [[Data]] page","zoom":11,"latitude":40.8,"longitude":-74,"data":{"type":"FeatureCollection","features":[{"type":"Feature","properties":{"title":{"en":"Alphabet City","ru":"Алфабет-сити"}},"geometry":{"type":"Polygon","coordinates":[[[-73.980356454849,40.730425548938],...
"sources" must be no more than 400 symbols long. Special characters like new lines\n and tabs\t are not allowed.<mapframewidth="500"height="500">[{"type":"ExternalData","service":"geoshape","ids":"Qxxxxx"},{"type":"ExternalData","service":"page","title":"Sample.map"}]</mapframe>
The sources are drawn in the order in which they are listed in the code—in the example above, the geoshape from Wikidata will appear beneath the components from the data page.This would be reversed if the data page was called before the Wikidata ID.
.map pages from a related Wikidata item