Wikipedia:Creating route maps from OpenStreetMap data

This is a tutorial for creating interactive maps on Wikipedia for lines, using OpenStreetMap data, available on a compatible Open Database License. This is designed for transit routes, but is easily applicable for creating maps of roads, rivers, and other linear objects. For maps of shapes (neighborhoods, parks, historic districts, campuses, and most other present-day sites), see Creating shape maps from OpenStreetMap data.

This tutorial requires basic knowledge of: If you need help please use the talk page, User talk:Ɱ, or Module talk:Mapframe.
 * finding Wikidata IDs
 * using Maplink and its parameters (some helpful substitutes may be Infobox mapframe and Maplink-road)

Part 1: Finding the route data
There are three methods you can use to find the route data you want for your map:

Method 1: Wikidata
The first thing to try is the easiest. There's a possibility your data is already linked and you're ready to map. Create a test map in your sandbox. You'll need to use Maplink together with the Wikidata ID of the route/line. As an example: If it displays, great. You can use the map and add parameters to make it display to your liking. If the map data does not populate, the below methods are straight-forward and reliable:

Method 2: Using the OpenStreetMap website

 * 1) Go to OpenStreetMap and zoom into the general area where the route runs.
 * 2) Switch to the "Transport Map" layer using the Antu dialog-layers.svg 'Layers' sidebar on the right.
 * 3) Now you should see all the transit routes highlighted on the map, with numbers indicating the route numbers. Select a route by right-clicking (control-click on Macs) and selecting 'Query features'.
 * 4) Then search through the list for the route you desire; selecting it will bring you the relation representing the route, with the route displayed beside it on the map.

Method 3: Using the OSM Relation Analyzer
If you already know how the relation would be tagged, the OSM Relation Analyzer can be more convenient:
 * 1) Go to the OSM Relation Analyzer.
 * 2) Set Relation Type to route.
 * 3) Set Network to a route network identifier, such as COTA, or set Operator to an agency name, such as Central Ohio Transit Authority.
 * 4) Set Ref Tag to the route number, for example 10.
 * 5) Optionally set Route to bus if the same agency assigns the same route number to a bus line and another kind of route.
 * 6) Click 'Search'.
 * 7) Click the relevant relation ID (generally several digits long), then click 'Browse' to see it on the OpenStreetMap website.

Part 2: Embedding the route into an article
There are two ways to embed the route into an article, both using the maplink template:

Method 1: Using Wikidata
If the route has a Wikidata item and the OpenStreetMap route relation already has a  tag set to that item's QID, you can embed a map of the route directly onto a Wikipedia article as external data. Use the maplink template, setting the id parameter to the QID, such as Q88466277. Normally, changes to the route in OpenStreetMap are reflected in the article within about two days.

Example:

Method 2: Using Wikimedia Commons
Using map data on Wikimedia Commons:
 * 1) Paste the relation ID into this Overpass query, replacing '8343040'. The ID filter is actually one of many possible filters you could use here.
 * 2) Run the query, then click 'Export' in the toolbar and select the 'copy' part of ' download / copy as GeoJSON'
 * 3) In Wikimedia Commons, create a page in the Data: namespace with the .map extension, like Data:COTA10.map
 * 4) When you create the page, replace the 'Data' placeholder (including the two brackets) with the GeoJSON you copied.
 * 5) Uncomment the line  and save the page.
 * 6) You may need to adjust the coordinates or zoom level in order for the map to display properly; here you can also add parameters for line width, color, etc.
 * 7) The route may also come with points indicating stops or stations; if you do not want to include these, you would have to remove the feature data, located at the end of your Json data.
 * 8) Then you can use the map data in Wikipedia articles, through maplink using the parameter COTA10.map, or manually, like seen here.

Example:

If the route changes in OpenStreetMap, repeat steps 1 through 3 to update the existing Wikimedia Commons map data page.