User:DTankersley (WMF)/misc/how to: maps

Screenshot of an easy to create map of Estes Park, CO

Let's add interactive maps for a richer experience using maplink edit

This is a how-to guide for creating simple but beautiful maps that use OpenStreetMap data and Wikimedia tile images. We've recently created a method to add maps to articles – using a link for users to click and view an interactive map – and wanted to have a step-by-step guide for new users. This new method is called maplink and more detailed information about the Maps project can be found here.

Find an article to update with a map

Let’s find an article that the addition of the map would make it just that much richer in content, an easy article would be the city that you live in, or a notable location nearby. For purposes of this guide and for the easy map samples, we'll use the small but very scenic town of Estes Park located in the state of Colorado in the USA.

Find the coordinates (latitude and longitude) for your map

The article for Estes Park has coordinates (latitude and longitude) in the information section: 40°22′38″N 105°31′32″W . This makes it easy for us to add in a maplink, in which to display an interactive map using Wikimedia tiles and map data from OSM.
Easy map: More details
If you click on the coordinates on the page, a new page is opened up that contains the GeoHack information for Estes Park. We’ll need to copy the coordinates that are in decimal degrees as displayed: 40.377117, -105.525514.

Add a map link to your page

Now that you know where you want to add a map and have the coordinates, it's time to have fun adding links to interactive maps to your articles or media.

Additional information about your map

  • Each map that you create, once the link is clicked on, will open in a new tab (or window).
  • Every map is fully interactive. It can be zoomed in and out or panned to view different areas.
  • Each map will have a caption below the map that will contain (by default) the center of the map coordinates or custom text.
  • There is a more details button that displays additional ways to display the map: satellite, topological, terrain, aerial or other external service providers (as available). The more details button is meant as a replacement for the GeoHack templated map service.
  • Each map will have a attribute line with a link to the OpenStreetMap copyright and license as well as a link to the Wikimedia maps terms of use and licensing page.
  • The interactive map can be closed by clicking the X in the top right hand corner of the map, clicking your browser's back button (if the map opened in your existing browser tab) or closing the tab (if the map opened in a new tab or window).

Easy map link samples edit

Just a link with coordinates: 40°22′38″N 105°31′32″W

Easy map: Just a link with coordinates
<maplink latitude="40.377117" longitude="-105.525514" />

A link with custom text: Estes Park, CO You can also add in custom text to display something like this:

<maplink latitude="40.377117" longitude="-105.525514" text="Estes Park, CO" />

A link with custom text without a map icon in your article: An interactive map of Estes Park, CO If you would prefer your map link to display without the map icon, you can edit your code to be something like this:

<maplink latitude="40.377117" longitude="-105.525514" text="An interactive map of Estes Park, CO" class="no-icon" />

Set a custom zoom level for the map, once it's opened: A custom zoom level map of Estes Park, CO Let's now set a zoom level for the interactive map, since you might want to display your map closer into the city:

<maplink latitude="40.377117" longitude="-105.525514" text="A custom zoom level map of Estes Park, CO" zoom="15" />
Please read the notes after the code samples to be more informed about things that are good to know.

Cool but complex things you can do with a map edit

Add a marker to your map: Colorado State Capital with marker icon

Click edit source on this page to view the code for creating this map.

Add a marker and article link to your map: Colorado State Capital with marker and article link

Click edit source on this page to view the code for creating this map.

Add a custom icon marker, article link and image to your map: Colorado State Capital with a town hall marker, article link and image

Complex map: Marker, article link and image
<maplink text="Colorado State Capital with a town hall marker,
article link and image" latitude="39.73939" longitude="-104.98491" zoom="17">{  
   "type":"Feature",
   "properties":{  
      "marker-symbol":"town-hall",
      "marker-color":"46ea5f",
      "marker-size":"medium",
      "title":"[[wikipedia:Colorado_State_Capitol|Colorado State Capital]]",
      "description":"[[File:Coloradocapitolhill2.JPG|150px]]"
   },
   "geometry":{  
      "type":"Point",
      "coordinates":[  
         -104.98485267162323,
         39.73928364167763
      ]
   }
}</maplink>
Complex map sample with several map markers in different sizes using a feature collection

Add a Wikidata ID to highlight a state (geoshape): State of Colorado, outlined

Click edit source on this page to view the code for creating this map.

Add a Wikidata ID to mask everything but a state (geomask): State of Colorado, highlighted

Click edit source on this page to view the code for creating this map.

Add a number to a map marker: Colorado State Capital with a number marker

Click edit source on this page to view the code for creating this map.

Add a letter to a map marker: Colorado State Capital with a letter 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: Denver Amusements

Click expand to show the code for this map...
<maplink text="Denver Amusements" latitude="39.74956567318853" longitude="-105.01247406005858" zoom="14">{  
   "type":"FeatureCollection",
   "features":[  
      {  
         "type":"Feature",
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -105.00768899917603,
               39.74859230437501
            ]
         },
         "properties":{  
            "title":"[[wikipedia:Pepsi_Center|Pepsi Center]]",
            "marker-color":"420617",
            "marker-symbol":"-letter-see",
            "marker-size":"small"
         }
      },
      {  
         "type":"Feature",
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -105.01238822937012,
               39.7526011757416
            ]
         },
         "properties":{  
            "title":"[[wikipedia:Downtown_Aquarium%2C_Denver|Downtown Aquarium Denver]]",
            "marker-color":"508e33",
            "marker-symbol":"-letter-see",
            "marker-size":"medium",
            "description":"[[File:Denver-DTA.jpg|150px]]"
         }
      },
      {  
         "type":"Feature",
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -105.01247406005858,
               39.74956567318853
            ]
         },
         "properties":{  
            "title":"[[wikipedia:Confluence_Park|Confluence Park]]",
            "marker-color":"0d2751",
            "marker-symbol":"-letter-see",
            "marker-size":"large"
         }
      },
      {  
         "type":"Feature",
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -105.01646518707275,
               39.74656303364532
            ]
         },
         "properties":{  
            "title":"South Platte Bike Trail",
            "marker-color":"61b9e2",
            "marker-symbol":"-number-see",
            "marker-size":"medium"
         }
      },

   ]
}</maplink>

Add groups of different colored map markers and different counters: Add groups of different colored markers and different counters

Click expand to show the code for this map...
<maplink text="Add groups of different colored markers and different counters" width="350" height="350" zoom="13" longitude="-122.39902496337889" latitude="37.80151060070086">{  
   "type":"FeatureCollection",
   "features":[  
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-number",
            "marker-color":"302060"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.41816520690917,
               37.79097260220947
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-number",
            "marker-color":"302060"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.40786552429199,
               37.799654055191525
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-number",
            "marker-color":"302060"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.40185737609865,
               37.796262984039544
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-number",
            "marker-color":"302060"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.38743782043457,
               37.80535070427755
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-number",
            "marker-color":"302060"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.38005638122557,
               37.795449103799726
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-letter",
            "marker-color":"208020"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.40941047668457,
               37.81850557172186
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-letter",
            "marker-color":"208020"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.40357398986815,
               37.81280993744834
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-letter",
            "marker-color":"208020"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.39842414855956,
               37.8071138637568
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-number-bar",
            "marker-color":"f01080"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.41181373596191,
               37.78595317184089
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-number-bar",
            "marker-color":"f01080"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.39542007446289,
               37.787674400057654
            ]
         }
      },
      {  
         "type":"Feature",
         "properties":{  
            "marker-symbol":"-number-bar",
            "marker-color":"f01080"
         },
         "geometry":{  
            "type":"Point",
            "coordinates":[  
               -122.38649368286131,
               37.78401144262929
            ]
         }
      }
   ]
}</maplink>


Good things to know about using map links edit

  • 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.
  • All available speciality icons can be viewed at Maki Icons.
  • 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.

See also edit