View source for Wikipedia:WikiProject U.S. Roads/Maps task force/Tutorial

{{Wikipedia:WikiProject U.S. Roads/Dept header |logo= USRD MTF.svg |dept=Map Tutorial |type=sub|WP:USRD/MTF/T}}
{{Wikipedia:WikiProject U.S. Roads/nav|type=dept}}

==Creating a KML file==
===Using Google Earth===
:''This portion of the tutorial was contributed by [[User:Floydian]].''
The simplest method for most people to create a KML file is using [[Google Earth]], which is free and works on most modern computers.
;First time setup
:''[http://www.google.com/earth/index.html Get Google Earth]''<!--CR In-line link:Justified ad this is necessary to the following--> ''[http://www.liberiangeek.net/2011/03/install-google-earth-ubuntu-11-04-natty-narwhal/ Ubuntu 11.X tutorial]''
#Start up the software.<!--Not in a repository- quite complex--> 
#In the Tools menu, at the top, select ''Options...'' to bring up the ''Google Earth Options'' dialog. By default it should be on the ''3D View'' tab. If not, set it to be.
#*In the Mac version, select the ''Google Earth'' menu and ''Preferences...''
#Under ''Terrain Quality'', set the ''Elevation Exaggeration'' to 0; press Ok.
#*This eliminates the surface elevations, making it easier to spot straight lines.
#On the left are three collapsible navigation panes: Search, Places and Layers.
#Start by unchecking all of boxes in the Layers pane except ''Borders and Labels'' and ''Places''.
#*You may optionally wish to use the roads layer, but it can be a hindrance at times.
#In the ''Places'' pane, on the left, you will see the ''My Places'' tree, and ''Temporary Places''. Right-click ''My Places'' and Add>Folder in which to save your routes.

;Drawing
#In the ''Places'' pane, right-click the folder you are storing your routes in and select Add>Path to bring up the ''Google Earth - New Path'' dialog box.
#Name it after your highway
#In the ''Style, Color'' tab, set the color to pure red (second column, fourth row in the palette or r:255 g:0 b:0) and set the width to 5.0.
#'''Without closing the dialog box''', start tracing your line. You may want to drag the dialog box over to the side; it can be annoying.
#*Once the dialog box has lost focus (i.e. you click to place your first point on the map), you can use your arrow keys to pan the map.
#Create your line, point-by-point.

;Exporting
#Once you have finished tracing your line, press ok on the dialog box to close it. Your new path should be listed in the ''Places'' pane, within your folder.
#Right-click that entry (or the line itself on the map), and select ''Save Place As...''
#Change the ''Save as type'' to Kml (it defaults to .kmz when you start the program).
#Save the file
#Locate the file on your computer and open it with a plain text editor.
#Select all>Copy
#Now create a new subpage of [[Template:Attached KML]] using the title of the article – [[Ontario Highway 401]] becomes [[Template:Attached KML/Ontario Highway 401]])
#Paste the content into this new page and save.
#Now add {{tl|Attached KML}} to the article itself, in the External links section if it exists.
#Profit.

====Observation====
:''This portion of the tutorial was contributed by [[User:Fredddie]].''
It is possible to add more than one .kml file to the KML subpage; that is, you can add a business route if you so desire.  However, only Bing Maps will show both routes correctly.  Google Maps will only show the last kml file on the page.  If you add a business route, it ''must'' come before the mainline, otherwise Google Maps will only display the business route.

*By copying the <Placemark></Placemark> and everything in between, you can merge multiple segments into a single KML file.
*You can also export a folder in Google Earth as a KML, and it will contain all the lines within that folder when you saved it.

====Editing an existing file====
:''This portion of the tutorial was contributed by [[User:SounderBruce]].''
#Copy the text in the [[Template:Attached KML]] subpage into a blank text file 
#Save the file as a .kml ''(see the Exporting section above)'' and open it in Google Earth
#In the ''Places'' pane, right-click on your KML file select and "Properties" from the menu
#Use your mouse to hover over the desired points in the path that you would like to change. It should be highlighted in a color different from your path's (by default, green or blue)
#From here you have several options:
#*Left-click and drag to move the point
#*After left-clicking a point, click outside of the KML's path to create new points and a line that travels to the nearest point to your initial point
#Points can be deleted by hovering over
#Click the ''Save'' button in the dialog box to save. You can also click ''Cancel'' and undo changes made to KML since the last saved version
#Export the KML as shown in the ''Exporting'' section above, preferably to a new file
#Copy and paste the changed coordinates of your new KML file into the [[Template:Attached KML]] subpage. Make sure to leave an informative edit summary describing what areas were changed.

===Using Google Maps===
:''This portion of the tutorial was contributed by [[User:Thewombatguru]].''

Creating a KML file using this method will only take you about 10 minutes on average and the only things you need are a Google-account and a text-editor.

#Go to [http://maps.google.com Google Maps].
#Sign in to your account.
#Click on "My custom maps" and then click on "Create".
#Rename "Untitled map" in the top right corner to the name of the road.
#Click on the "Add directions" icon underneath the search bar.
#Enter the beginning and end of the road at "A" and "B", drag the markers to the exact places on the map if they are a bit off.
#Check if the given route follows the roads you want, if it doesn't, hold down the left mouse button on a part of the route and drag it to the desired road.
#Name your just created directions after the name of the road, followed by a brief description. (e.g. "Test route 54 - West to East" if the route is called "Test route 54")
##Repeat step 5 through 8 if you want to have more routes on the same map.
#Delete the empty "Untitled layer" by clicking on it, then selecting the little downwards arrow and clicking "Delete this layer". Confirm you want to delete it.
#Click on the folder button next to the "Add layer" button and click "Export to KML", then click "Download" and save it somewhere on your computer.
#Unzip the .kmz file you downloaded, inside should be a .kml file. (You might have to change the file extension to .zip first)
#Open the .kml file with a text editor (preferably [http://notepad-plus-plus.org Notepad++]).
#Replace the text in between the third "<code>&lt;Name&gt;</code>" and "<code>&lt;/Name&gt;</code>" parameters with the text in between the second "<code>&lt;Name&gt;</code>" and "<code>&lt;/Name&gt;</code>" parameters, and rename that text to the name of the route. (e.g. "Test route 54")
#Scroll down through the coordinates of the first route until you see "<code>&lt;/coordinates&gt;</code>".
##If you made another route, delete everything from "<code>&lt;placemark&gt;</code>" to the third "<code>&lt;/name&gt;</code>".
##Add a "0" to the "<code>&lt;styleUrl&gt;</code>" paramater. (e.g. from "<code>&lt;styleUrl&gt;#line-1267FF-1&lt;/styleUrl&gt;</code>" to "<code>&lt;styleUrl&gt;#line-1267FF-10&lt;/styleUrl&gt;</code>")
##Replace the text in between the "<code>&lt;Name&gt;</code>" and "<code>&lt;/Name&gt;</code>" parameters with the name of the road followed by a brief description. (e.g. "Test route 54 - East to West" if the route is called "Test route 54")
###If you made even more routes, repeat step 13, but for the third route add two "0"s, for the fourth three "0"s, etc.
#Scroll down through the coordinates of the last route until you see the "<code>&lt;/coordinates&gt;</code>" parameter. Delete everything from "<code>&lt;placemark&gt;</code>" to the second "<code>&lt;/placemark&gt;</code>"
#If you made more than 1 route, copy the last "<code>&lt;style&gt;</code>" section and paste it underneath it.
##Add "0"s to the style ids so they correspond with the ids given before. (e.g. from "<code>&lt;Style id='line-1267FF-1&gt;</code>" to "<code>&lt;Style id='line-1267FF-10&gt;</code>")
##Change the figure in between the "<code>&lt;width&gt;</code>" and "<code>&lt;/width&gt;</code>" parameters to "5".
##Change the figures and letters in between the "<code>&lt;color&gt;</code>" and "<code>&lt;/color&gt;</code>" for the first route to "FF0000FF", for the second route to "FF00FFFF", and for all remaining routes to "FFFF0000".
#Save the file and copy all the text.
#Go to [[Template:Attached KML|Template:Attached KML/]] followed by the exact name of the road article, paste the text on the new page, and safe it. (e.g. for road "Test route 54" go to [[Template:Attached KML/Test route 54]])
#Add {{tlx|Attached KML|display{{=}}inline,title}} to the road article itself in the "References" or "External Links" sections. See link below.
#Go to the talk page of the road article and edit the page, add "<code>needs-kml=no</code>" to the {{tl|WikiProject U.S. Roads}} template or change "<code>needs-kml=yes</code>" to "<code>no</code>".
#You've now created your KML file and added it to the corresponding article. Congratulations!
{{Attached KML|from=Test route 54|display=inline,title}}

===Using qGIS and shapefiles===
:''This portion of the tutorial was contributed by [[User:Scott5114]].''

Having created a map as shown above, creating a [[KML]] file to attach to the article is simple. You can think of a KML file as basically a stripped-down version of a [[shapefile]]—it contains a set of geographic coordinates that express your route's location. However, while a shapefile encodes the coordinates as binary data, KML is expressed as textual [[XML]] data, which is easier to parse and edit. KML files are supported by many mapping applications, such as [[Google Earth]], and can be reused by many people outside the project for a variety of purposes. Online mapping apps like Google Maps and Bing can also read and display KML files, which means that readers can choose to see the route highlighted on a map with towns and cities labeled that they can zoom in on and pan. The utility of generating a KML file is a no-brainer.

#You will need to have finished creating a map in QGIS in the manner described above. This walkthrough begins after approximately Step 22 of the above tutorial.
#Right-click the layer containing the "highlighted road" (the layer that contains just the road of interest, colored red). Select "Save as...".
#A dialog called "Save vector layer as..." should appear. Change the "Format" dropdown to "Keyhole Markup Language [KML]".
#Move down to the line labeled "CRS" and click "Browse". 
#Expand the "Geographic Coordinate Systems" entry on the tree view. Find "[[WGS 84]]" and select it. Click "OK". (In the future, you will be able to select WGS 84 from the "Recently used coordinate systems" list.)
#Select a location to save the KML file to.
#Finally, click OK on the "Save vector layer as..." dialog. QGIS should notify you that the export was completed successfully.
#Open the KML you just generated in a text editor such as Notepad, emacs, etc.
#Copy '''all''' text in the KML file to the clipboard.
#Now you'll create a subpage of [[Template:Attached KML]] corresponding with the title of the article (for example, for the article [[Oklahoma State Highway 84]], the KML page will be [[Template:Attached KML/Oklahoma State Highway 84]]. (Create this by going to the search box and typing in << Template:Attached KML/[name of page you have map for] >>. Wikipedia will tell you that page does not exist and allow you to create it. In this example, you'd type <<Template:Attached KML/Oklahoma State Highway 84 >> into the search box to create the subpage for it.)
#Paste the KML text into this page and save. '''Do not attempt to format it; doing so will break the XML.''' Any wikicode intermingled in the KML page will cause parsing problems. You may wish to note in the edit summary that the KML was generated with the same data as the article's map.
#Go to the article and place the text ''{{tl|Attached KML}}'' in the article right below the heading for External Links. The template should be placed in the External Links section because it contains links to external websites.<!--See also is for other pages/articles on the English Wikipedia, not external websites.--> This ''Attached KML'' text with the curly brackets tells Wikipedia to look for the template with the same name as as page you are looking at and display that KML in the format set up for Wikipedia to display it. (Smart, hugh.)
#You're done! Users can now use the KML data.

===Alternative using qGIS and shapefiles===
:''This portion of the tutorial was contributed by [[User:Allen4names]].''

:You will need Quantum GIS and the shapefiles. I am using version 1.8.0 of qGIS for this tutorial.

# Open the <code>[[.shp]]</code> file(s) that have the data you want in qGIS.
#* For the example below I am using <code>s53nhpn.shp</code> (archive filename s53nhpn.zip) from the web site linked above.
# Go to the attribute table (right click on each layer) and select the records you want to use.
#* In this example I clicked on "SIGN1" at the top of the attribute table window and scrolled down to U12. I selected records 4023-4079 and repeated with "SIGN2" and "SIGN3" making sure not to unselect any.
# In the main window choose right click on each layer and choose "Save selection as...". Choose a file name and save.
#* Make sure that the format is "Keyhole Markup Language [KML]".
# Edit the file in a plain text editor to replace each instance of "<code>&lt;LineStyle&gt;&lt;color&gt;ff0000ff&lt;/color&gt;&lt;/LineStyle&gt;</code>" with "<code>&lt;LineStyle&gt;&lt;color&gt;ff0000ff&lt;/color&gt;&lt;width&gt;5&lt;/width&gt;&lt;/LineStyle&gt;</code>" and save.
# Check the file using [[Google Earth]] or paste the resulting code into a KML sandbox to test it using Google Maps or Bing Maps.
#* Example URLs: https://maps.google.com/maps?q=http%3A%2F%2Fen.wikipedia.org%2Fw%2Findex.php%3Ftitle%3DUser%3AAllen4names%2FKML_sandbox%26action%3Draw http://www.bing.com/maps/default.aspx?mapurl=http%3A%2F%2Fen.wikipedia.org%2Fw%2Findex.php%3Ftitle%3DUser%3AAllen4names%2FKML_sandbox%26action%3Draw
# If there is nothing wrong you can create a subpage of {{Tl|Attached KML}} using the code you created and add the template to the article.
#* It should be noted that I did find errors. There where two missing sections. One along I-5 and the other along I-82.

===Using ShareMap.org social web mapping service===
[[File:Sharemap org screenshot.png|thumb|Sharemap org screenshot]]
;''This portion of the tutorial was contributed by [[User:Jkan997]].''
# Go to ShareMap.org and create map (registration not required, but recommended)
# Draw your map, import data from Natural Earth and OpenStreetMap (with wizard or pure XAPI queries)
# Save map
# Go to tools tab in view mode and select KML export
# Save exported KML file
;More informations: [http://sharemap.org/ here]
;Recorded screencasts: [http://www.youtube.com/user/ShareMap here on YouTube]

== Creating an SVG file ==
This is a tutorial for creating road maps for [[WP:USRD]] with [[QGIS]] and [[Inkscape]]. This tutorial was originally written by [[User:Xenon54|Xenon54]]. Contact him with any questions or inaccuracies.
# Install QGIS. For best results, use 2.18 Las Palmas which is the version this tutorial was written for. Newer versions will work too, just beware that some menus or options may be a little different compared to what the tutorial says. The latest version is currently {{Latest stable software release/QGIS}}. These links may not be up-to-date and are merely provided as a convenience; the official download page is [https://qgis.org/en/site/forusers/download.html here].
#Install Inkscape from [https://inkscape.org/release/ inkscape.org]. You'll be using it later.
#Now that you've downloaded QGIS, you need to feed it [[Geographic Information System]] data, herein referred to as just "data". It is freely available from many government and private sources. Here are some good places to start:
#*[http://www.fhwa.dot.gov/planning/nhpn/ National Highway Planning Network]. Data provided by [[Federal Highway Administration]], consists of roads in the [[National Highway System (United States)|National Highway System]]. These are all Interstates and US routes, plus major arteries.
#*[http://arcdata.esri.com/data/tiger2000/tiger_download.cfm Census 2000 TIGER/Line Data], provided by [[ESRI]] and the [[Census Bureau]]. Data for water and other physical features can be found here, as well as data for all streets (use with caution) and Census Designated Places.
#*Many state DOTs also have data. For example, the [[Ohio Department of Transportation]] provides [http://www.dot.state.oh.us/Divisions/TransSysDev/Innovation/Prod_Services/ESRIDWNLOADS/Pages/default.aspx data] for township and county boundaries, as well as each level of road designation.
#Once you're done downloading data, fire up QGIS. You should get a blank screen.
#Go to Layers -> Add a Vector Layer, or press V.
#Browse to wherever you saved your data. You should see a .shp file. Double click it to import it. NHS data (state-level) will have a name of the form SXXNHPN, where XX is the state's [[FIPS state code]] -- for example, S39NHPN for Ohio. Census/ESRI data, which is county-level, will be named tgrXXXXXabc, where XXXXX is the FIPS state code followed by the [[FIPS county code]] and abc is a code indicating which type of data the file represents -- for example, tgr39103wat holds data for water bodies in [[Medina County, Ohio]].
#We will be focusing on road data first. Now you should see a mass of lines, roughly forming the state's shape. It is time to give those lines some color. In the "Legend" on the left hand side, right-click the layer name and hit Properties. '''Note:''' this method will only work for NHS data. Census/ESRI street data does not contain sign designation data, only street names. You will have to leave this data all one color.
#Click Style on the Properties screen and find the drop-down menu that says "Single Symbol".  Click the menu and select "Categorized".  In previous versions, this was called "Symbology".
#In the "Column" drop-down, select "SIGNT1", then click the Classify button.
#A list of letters should appear. The amount is different for each state, but three are always present: "I" for Interstates, "U" for US Routes, and "S" for state highways.  Each type should be assigned a color automatically.
#Click each class you want to color. Click the "Outline Color" box to the right and assign a color to the class based on the standards at [[WP:USRD/MTF]]. Here you can also change the width and style of the lines in that class. If you don't want a class to appear, select it and hit "Delete Classes". When you are done, click OK. You can also assign a label to the class by typing a name in the Label box.
#If you downloaded non-road data, such as water or county lines, go into its Properties now. Leave the "Legend Type" at "Single Symbol", and assign the proper color. If you're doing county lines, make the line width rather thick (~.8) so it will show up correctly in step 29.
#You probably have noticed that the road whose article is getting the map (herein: the "highlighted road")  is orange or blue or some other color. You need to copy that road from the NHS layer to a new layer you will create to turn it red.
#There are two ways to select the road:
#:'''Lasso method:'''
#::#This is only ideal for short roads. On the main toolbar, look for an icon that looks like an arrow with a small "i" next to it. It's next to the pan tool.
#::#Click the arrows next to this icon, and select the icon that looks like an arrow with a box on top of a yellow shape.
#::#Zoom in (click the arrows next to the pan tool to find the zoom tool) to where you can see your road clearly. Hold control and select the road so the region you want to highlight red is colored yellow. You can switch between pan, zoom, and select, just don't let go of control.
#::# Once you're done selecting, let go of control. Find the blue pen (edit layer) icon, then click the arrows a few icons to the right. Click the "copy selected" icon.
#:'''Attribute table method'''
#::#Ideal for longer roads, but tough for roads such as the [[Ohio Turnpike]] that carry two different non-concurrent designations. Begin by right-clicking the NHS layer and selecting Open Attribute Table.
#::#A bunch of numbers, looking like a nightmare Excel file, appear. However, some of the numbers are very helpful. Scroll over to the SIGN1 column. This is the designation of the road and is a combination of the next two columns, SIGNT1 (type, which you may remember we used in coloring) and SIGNN1 (number). Concurrencies are indicated by additional entries in SIGN2 and SIGN3. To the right of SIGNN3 is LNAME, the name of the road segment being described by that row, followed by MILES and KM, which should be self-explanatory.
#::#Now, notice the search box at the bottom. Type the designation of the road you want to highlight (e.g. S11 for a State Route 11), select SIGN1 in first drop-down box, "show only matching" (or "select and bring to top", or "select", whichever you prefer) in the next drop-down box, then finally click Search.
#::#The matching records (hopefully corresponding to the road you want to highlight) will be selected or move to the top, depending on which option you picked. Select them and hit the "Copy selected rows to Clipboard" icon.
#Whichever method you picked, the road you want to highlight should now be yellow. Press N to create a new layer. Under "Type", select "Line". QGIS demands that you define an attribute here. An attribute is a column in the attribute table, such as "SIGN1". It doesn't matter what you call it or what type it is, just define one and click OK.
#QGIS asks you to pick a location to save the .shp file. Pick one and save it. The filename will be the name of your layer.
#Select the layer in the Legend on the left-hand side. Click the blue pen icon to enter into edit mode. Click the arrows to the right of the blue pen icon but to the left of the hand icon. Click the Paste icon in the box that appears.
#Click the blue pen icon to exit edit mode. Save the layer. If you get an "unable to commit changes" error, click don't save. It seems to save anyway.
#Finally, right-click the layer you just created. Click Properties, then the Symbology tab. Leave the Legend Type at "Single Symbol". Now, click on the Outline color box and make the highlighted road red. Be sure to change the width to make it stand out.
#At this point, the highlighted road (remember, the road the map is showing the path of) should be red.
#Now save: File -> Save Project. This will save the current layers and view as a .qgs file.
#Export the map as an file that can be used in Inkscape. To export it as a PNG, go to File -> Save as Image. Pick a place to save the image (preferably one where you'll remember where you saved it) and save as a PNG file. To export it as an SVG, see [[/SVG maps|this page]] for the remainder of the tutorial.
#'''You're done with QGIS. Open Inkscape.'''
#Open the PNG file you just saved.
#Go to Path -> Trace Bitmap. A dialogue box will appear.
#Under "Multiple scans", select "Colors". Untick the "Smooth" box. Untick the "Stack scans" box.
#Click on the image to select it, then click Update to preview the trace.
#If you're satisfied with the preview, click OK and wait for potrace to work its magic.
#Once potrace is finished, move the traced image out of the way and delete the PNG. Put the traced image back when you're done. After you do this, right-click on the image and hit Ungroup. Now each color is a separate path. Interstates are all one path, state and US routes are all one path, but most importantly the highlighted road is its own path. This will make it easier to update the map for alignment changes, extensions, or truncations.
#You can add shields if you want. Use the SVG shields found on Commons. Be sure to save the SVGs, then go to File -> Import to add them to the map. If you don't, the thumbnail won't display come upload time.
#If you added shields, make sure to convert the shield text to path if necessary. Then, save as an SVG.
#'''You're done with Inkscape. Go to [[Commons:Main Page|Commons]].'''
#Upload your image. Remember to tag with {{tlxc|Created with Inkscape}} or {{tlxc|Inkscape-hand}}.
#Add your image to the article. Most, if not all, use {{tl|Infobox road}}, which has a <code>map</code> parameter. Add in the form <code>map=map_name</code> where <code>map_name</code> is just the file name of the map (e.g. OHSR 8 map.svg, not File:OHSR 8 map.svg). Text can be displayed with the <code>map_notes</code> parameter.
'''Congratulations! You are finished!'''


[[Category:WikiProject U.S. Roads departments|Maps tutorial]]