User:CKoerner (WMF)/Help:Maps

This is a how-to guide for creating simple but beautiful maps that use OpenStreetMap data and Wikimedia tile images.

Wikimedia maps allow contributors to insert interactive maps into MediaWiki pages with a link, called maplink or as an embedded image called mapframe.

General
To add a link to a map, add the following code in the page. This displays a link that will automatically convert the latitude and longitude into degrees, minutes and seconds.

Result: Note: Width and height of the thumbnail must be specified.

Result: 

Maplink
Maplink can have custom text.

Result:

Result:

Result:

Result: 

Markers
Markers can be added to maps to denote a location. These features are added using the JSON format.

These examples use maplink, but the formatting for mapframe is the same.

Result:

Markers can also contain information such as images and links to articles.

Result (interact with marker to see result):

Wikidata IDs for OSM data can be used to highlight borders using the geoshape service.

Result:

Wikidata IDs can be used to mask the entire map except a specified region.

Result:

Markers can be numbered.

Result:

Add a letter to a map marker:
 * Click edit source on this page to view the code for creating this map.

Add several map markers in different sizes using a feature collection:
 * Click edit source on this page to view the code for creating this map.

Add groups of different colored map markers and different counters:
 * Click edit source on this page to view the code for creating this map.

More on markers

 * Map zoom levels are between 0 (zero) and 18 (eighteen).
 * Map markers can use any color that has a RBG value (a quick internet search of "rgb color picker" will show several options).
 * Markers can be one of three different sizes: small, medium or large.
 * This page shows examples and names of all markers that work with our maps.
 * Some of the more complex map links will have a different link display.
 * GeoJSON that is created elsewhere can be copied (in accordance with licensing and copyright restrictions) and then pasted into maplink (for example)
 * If you are creating maps on Wikivoyage, it might be a good idea to use Groups for more information.
 * If you want to learn more about adding external data to your map, this is a good place to start.

Available location icons
This page lists the set of icons (Maki) as they appear on Wikimedia Maps.

Note: Some icons are not available and the coordinates do not matter. (See ).

 { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, 0] }, "properties": { "title":"Maki Icon: aerialway", "marker-symbol":"aerialway"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, 0] }, "properties": { "title":"Maki Icon: airfield", "marker-symbol":"airfield"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, 0] }, "properties": { "title":"Maki Icon: airport", "marker-symbol":"airport"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, 0] }, "properties": { "title":"Maki Icon: alcohol-shop", "marker-symbol":"alcohol-shop"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, 0] }, "properties": { "title":"Maki Icon: america-football", "marker-symbol":"america-football"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, 0] }, "properties": { "title":"Maki Icon: art-gallery", "marker-symbol":"art-gallery"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, 0] }, "properties": { "title":"Maki Icon: bakery", "marker-symbol":"bakery"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, 0] }, "properties": { "title":"Maki Icon: bank", "marker-symbol":"bank"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, 0] }, "properties": { "title":"Maki Icon: bar", "marker-symbol":"bar"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, 0] }, "properties": { "title":"Maki Icon: baseball", "marker-symbol":"baseball"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, 0] }, "properties": { "title":"Maki Icon: basketball", "marker-symbol":"basketball"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, 0] }, "properties": { "title":"Maki Icon: beer", "marker-symbol":"beer"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.05] }, "properties": { "title":"Maki Icon: bicycle", "marker-symbol":"bicycle"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.05] }, "properties": { "title":"Maki Icon: building", "marker-symbol":"building"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.05] }, "properties": { "title":"Maki Icon: bus", "marker-symbol":"bus"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.05] }, "properties": { "title":"Maki Icon: cafe", "marker-symbol":"cafe"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.05] }, "properties": { "title":"Maki Icon: camera", "marker-symbol":"camera"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.05] }, "properties": { "title":"Maki Icon: campsite", "marker-symbol":"campsite"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.05] }, "properties": { "title":"Maki Icon: car", "marker-symbol":"car"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.05] }, "properties": { "title":"Maki Icon: cemetery", "marker-symbol":"cemetery"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.05] }, "properties": { "title":"Maki Icon: chemist", "marker-symbol":"chemist"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, -0.05] }, "properties": { "title":"Maki Icon: cinema", "marker-symbol":"cinema"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, -0.05] }, "properties": { "title":"Maki Icon: circle", "marker-symbol":"circle"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, -0.05] }, "properties": { "title":"Maki Icon: circle-stroked", "marker-symbol":"circle-stroked"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.1] }, "properties": { "title":"Maki Icon: city", "marker-symbol":"city"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.1] }, "properties": { "title":"Maki Icon: clothing-store", "marker-symbol":"clothing-store"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.1] }, "properties": { "title":"Maki Icon: college", "marker-symbol":"college"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.1] }, "properties": { "title":"Maki Icon: commercial", "marker-symbol":"commercial"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.1] }, "properties": { "title":"Maki Icon: cricket", "marker-symbol":"cricket"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.1] }, "properties": { "title":"Maki Icon: cross", "marker-symbol":"cross"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.1] }, "properties": { "title":"Maki Icon: dam", "marker-symbol":"dam"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.1] }, "properties": { "title":"Maki Icon: danger", "marker-symbol":"danger"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.1] }, "properties": { "title":"Maki Icon: dentist", "marker-symbol":"dentist"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, -0.1] }, "properties": { "title":"Maki Icon: disability", "marker-symbol":"disability"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, -0.1] }, "properties": { "title":"Maki Icon: dog-park", "marker-symbol":"dog-park"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, -0.1] }, "properties": { "title":"Maki Icon: embassy", "marker-symbol":"embassy"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.15] }, "properties": { "title":"Maki Icon: emergency-telephone", "marker-symbol":"emergency-telephone"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.15] }, "properties": { "title":"Maki Icon: entrance", "marker-symbol":"entrance"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.15] }, "properties": { "title":"Maki Icon: farm", "marker-symbol":"farm"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.15] }, "properties": { "title":"Maki Icon: fast-food", "marker-symbol":"fast-food"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.15] }, "properties": { "title":"Maki Icon: ferry", "marker-symbol":"ferry"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.15] }, "properties": { "title":"Maki Icon: fire-station", "marker-symbol":"fire-station"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.15] }, "properties": { "title":"Maki Icon: fuel", "marker-symbol":"fuel"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.15] }, "properties": { "title":"Maki Icon: garden", "marker-symbol":"garden"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.15] }, "properties": { "title":"Maki Icon: gift", "marker-symbol":"gift"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, -0.15] }, "properties": { "title":"Maki Icon: golf", "marker-symbol":"golf"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, -0.15] }, "properties": { "title":"Maki Icon: grocery", "marker-symbol":"grocery"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, -0.15] }, "properties": { "title":"Maki Icon: hairdresser", "marker-symbol":"hairdresser"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.2] }, "properties": { "title":"Maki Icon: harbor", "marker-symbol":"harbor"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.2] }, "properties": { "title":"Maki Icon: heart", "marker-symbol":"heart"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.2] }, "properties": { "title":"Maki Icon: heliport", "marker-symbol":"heliport"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.2] }, "properties": { "title":"Maki Icon: hospital", "marker-symbol":"hospital"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.2] }, "properties": { "title":"Maki Icon: ice-cream", "marker-symbol":"ice-cream"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.2] }, "properties": { "title":"Maki Icon: industrial", "marker-symbol":"industrial"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.2] }, "properties": { "title":"Maki Icon: land-use", "marker-symbol":"land-use"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.2] }, "properties": { "title":"Maki Icon: laundry", "marker-symbol":"laundry"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.2] }, "properties": { "title":"Maki Icon: library", "marker-symbol":"library"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, -0.2] }, "properties": { "title":"Maki Icon: lighthouse", "marker-symbol":"lighthouse"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, -0.2] }, "properties": { "title":"Maki Icon: lodging", "marker-symbol":"lodging"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, -0.2] }, "properties": { "title":"Maki Icon: logging", "marker-symbol":"logging"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.25] }, "properties": { "title":"Maki Icon: london-underground", "marker-symbol":"london-underground"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.25] }, "properties": { "title":"Maki Icon: marker", "marker-symbol":"marker"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.25] }, "properties": { "title":"Maki Icon: marker-stroked", "marker-symbol":"marker-stroked"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.25] }, "properties": { "title":"Maki Icon: minefield", "marker-symbol":"minefield"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.25] }, "properties": { "title":"Maki Icon: mobilephone", "marker-symbol":"mobilephone"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.25] }, "properties": { "title":"Maki Icon: monument", "marker-symbol":"monument"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.25] }, "properties": { "title":"Maki Icon: museum", "marker-symbol":"museum"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.25] }, "properties": { "title":"Maki Icon: music", "marker-symbol":"music"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.25] }, "properties": { "title":"Maki Icon: oil-well", "marker-symbol":"oil-well"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, -0.25] }, "properties": { "title":"Maki Icon: park", "marker-symbol":"park"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, -0.25] }, "properties": { "title":"Maki Icon: parking", "marker-symbol":"parking"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, -0.25] }, "properties": { "title":"Maki Icon: parking-garage", "marker-symbol":"parking-garage"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.3] }, "properties": { "title":"Maki Icon: pharmacy", "marker-symbol":"pharmacy"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.3] }, "properties": { "title":"Maki Icon: pitch", "marker-symbol":"pitch"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.3] }, "properties": { "title":"Maki Icon: place-of-worship", "marker-symbol":"place-of-worship"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.3] }, "properties": { "title":"Maki Icon: playground", "marker-symbol":"playground"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.3] }, "properties": { "title":"Maki Icon: police", "marker-symbol":"police"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.3] }, "properties": { "title":"Maki Icon: polling-place", "marker-symbol":"polling-place"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.3] }, "properties": { "title":"Maki Icon: post", "marker-symbol":"post"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.3] }, "properties": { "title":"Maki Icon: prison", "marker-symbol":"prison"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.3] }, "properties": { "title":"Maki Icon: rail", "marker-symbol":"rail"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, -0.3] }, "properties": { "title":"Maki Icon: rail-above", "marker-symbol":"rail-above"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, -0.3] }, "properties": { "title":"Maki Icon: rail-light", "marker-symbol":"rail-light"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, -0.3] }, "properties": { "title":"Maki Icon: rail-metro", "marker-symbol":"rail-metro"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.35] }, "properties": { "title":"Maki Icon: rail-underground", "marker-symbol":"rail-underground"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.35] }, "properties": { "title":"Maki Icon: religious-christian", "marker-symbol":"religious-christian"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.35] }, "properties": { "title":"Maki Icon: religious-jewish", "marker-symbol":"religious-jewish"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.35] }, "properties": { "title":"Maki Icon: religious-muslim", "marker-symbol":"religious-muslim"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.35] }, "properties": { "title":"Maki Icon: restaurant", "marker-symbol":"restaurant"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.35] }, "properties": { "title":"Maki Icon: roadblock", "marker-symbol":"roadblock"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.35] }, "properties": { "title":"Maki Icon: rocket", "marker-symbol":"rocket"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.35] }, "properties": { "title":"Maki Icon: school", "marker-symbol":"school"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.35] }, "properties": { "title":"Maki Icon: scooter", "marker-symbol":"scooter"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, -0.35] }, "properties": { "title":"Maki Icon: shop", "marker-symbol":"shop"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, -0.35] }, "properties": { "title":"Maki Icon: skiing", "marker-symbol":"skiing"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, -0.35] }, "properties": { "title":"Maki Icon: slaughterhouse", "marker-symbol":"slaughterhouse"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.4] }, "properties": { "title":"Maki Icon: soccer", "marker-symbol":"soccer"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.4] }, "properties": { "title":"Maki Icon: square", "marker-symbol":"square"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.4] }, "properties": { "title":"Maki Icon: square-stroked", "marker-symbol":"square-stroked"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.4] }, "properties": { "title":"Maki Icon: star", "marker-symbol":"star"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.4] }, "properties": { "title":"Maki Icon: star-stroked", "marker-symbol":"star-stroked"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.4] }, "properties": { "title":"Maki Icon: suitcase", "marker-symbol":"suitcase"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.4] }, "properties": { "title":"Maki Icon: swimming", "marker-symbol":"swimming"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.4] }, "properties": { "title":"Maki Icon: telephone", "marker-symbol":"telephone"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.4] }, "properties": { "title":"Maki Icon: tennis", "marker-symbol":"tennis"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.45, -0.4] }, "properties": { "title":"Maki Icon: theatre", "marker-symbol":"theatre"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.5, -0.4] }, "properties": { "title":"Maki Icon: toilets", "marker-symbol":"toilets"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.55, -0.4] }, "properties": { "title":"Maki Icon: town", "marker-symbol":"town"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, -0.45] }, "properties": { "title":"Maki Icon: town-hall", "marker-symbol":"town-hall"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, -0.45] }, "properties": { "title":"Maki Icon: triangle", "marker-symbol":"triangle"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, -0.45] }, "properties": { "title":"Maki Icon: triangle-stroked", "marker-symbol":"triangle-stroked"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.15, -0.45] }, "properties": { "title":"Maki Icon: village", "marker-symbol":"village"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.2, -0.45] }, "properties": { "title":"Maki Icon: warehouse", "marker-symbol":"warehouse"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.25, -0.45] }, "properties": { "title":"Maki Icon: waste-basket", "marker-symbol":"waste-basket"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.3, -0.45] }, "properties": { "title":"Maki Icon: water", "marker-symbol":"water"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.35, -0.45] }, "properties": { "title":"Maki Icon: wetland", "marker-symbol":"wetland"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.4, -0.45] }, "properties": { "title":"Maki Icon: zoo", "marker-symbol":"zoo"} } ] }

Sizes
 { "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0, 0] }, "properties": { "title":"\"marker-size\": \"small\"", "marker-size":"small", "marker-symbol":"airport"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.05, 0] }, "properties": { "title":"\"marker-size\": \"medium\"", "marker-size":"medium", "marker-symbol":"airport"} }, { "type": "Feature", "geometry":  { "type":"Point", "coordinates":[0.1, 0] }, "properties": { "title":"\"marker-size\": \"large\"", "marker-size":"large", "marker-symbol":"airport"} } ] }

 {     "type": "Feature", "properties": { "marker-symbol": "town-hall", "marker-color": "46ea5f", "marker-size": "medium", "title": "The White House"}, "geometry": { "type": "Point", "coordinates": [-77.0365, 38.8977] } }

Adding maps with the visual editor



 * This how-to guide will focus on embedding a map into your page using Visual Editor's Map template and mapframe. If you'd like to add a map link to your page using wiki markup, like this: , see this page for detailed information.

This is a quick guide for getting started to create simple but beautiful maps that use OpenStreetMap data and Wikimedia tile images.

We've recently created a new method called mapframe to embed maps into pages that can be clicked on to view an interactive map. More detailed information about the Maps project can be found here.

Using the Map template
Adding a map to your page can be done using Visual Editor - by selecting "Map" from the "Insert" menu. Adding a map in this manner gives you the ability to:
 * * define physical size and alignment as displayed on the page
 * * coordinates of the center of the map - it's latitude and longitude
 * * zoom level of the map
 * * addition of push-pin markers, lines and polygons
 * * copy and paste GeoJSON data



How-to video
View a quick video showing how to use the Map template to add an embedded to a page.

Editing the map data
Once you've created your base map, you'll probably have some edits that you'd like to do to it, like change the color of an icon or add in an article link. Click here to find out how to edit the mapframe data for more complex maps.

More complex mapframe samples (using wiki markup) can be found here.

Important notes

 * The map template is currently only available on certain wiki projects - MediaWiki and WikiVoyage.
 * Embedded maps are currently only available on certain projects - MediaWiki, Meta, Wikivoyage (all languages), and some Wikipedias (Catalan, Hebrew, Russian, Portuguese, Macedonian, French, Finnish, Norwegian, Swedish, Basque, Czech, Spanish).
 * When using mapframe</tt>, there will always be a static map image in the article page
 * Clicking on the static map image will open up the interactive map in your existing tab, or - right click on the map image and open in a new tab or window.

=See also =
 * Information on the Maps project
 * Terms of use and where the map data comes from
 * How to use objects from OpenStreetMap in your map
 * Kartographer, the MediaWiki extension used for maps
 * Kartotherian, the tile server implementation
 * How to use dynamic maps on Wikivoyage