Clinched Highway Mapping Start Page

Get started

Maps and stats summarizing your travels

The basic idea is to make a list of highway sections you have traveled and collect them into a plain text file to be submitted to Clinched Highway Mapping. The text file will be processed and converted into a set of custom stats pages and maps describing your travels.

For examples, you can browse the travel summaries of any of our users.

Simple steps

  1. Choose an alphanumeric username.

    Use only lowercase English letters (a-z), numbers (0-9), and underscores (_) in your username, and keep the name at or under 15 characters long. Avoid capital letters, characters with diacritical marks, and characters from other alphabets; otherwise your file will not be processed.

  2. Make a plain text file.

    Name the file username.list, replacing username with the username you chose. For example, if you choose the name "highwayguy", name your file "highwayguy.list".

  3. Make a list of highway sections you have traveled.

    The Highway Browser is designed to help you with this process. The Highway Browser lists all available highways that you can use. For each highway, the Highway Browser also provides a list of waypoints that you can use as a start or end point.

    Break up your travels into traveled sections by highway and region. For each highway section, add one line to your .list file with the following format:

    For example, if you traveled on Interstate 70 in Illinois, USA between the Missouri border and Exit 52, you would put the following line in your file:

    That text comes from the blue text in the HB, shown here in the areas highlighted in yellow:

    Illinois I-70 in the Highway Browser

    See our Examples page for more examples of how to break down your travels into "sections" to enter into the file.

  4. Check your work.

    Make sure the following items are correct:

    • Each line has exactly the four required fields: region, highway, and two waypoint labels.
    • The fields have only a single space between them. Tabs, commas, or other delimiters may prevent the mapping script from parsing your file correctly.
    • The file is saved as plain text with a .list extension. Word processor files (Microsoft Word, Open Office Write, etc.) and rich-text formats will not work. If you use a word processor to create your file, be sure to select "Save As..." and save the file in a plain text format.
    • Including a small number of blank lines is acceptable. You might wish to break up your list into chunks by region or highway type to make it easier to read or manage.
  5. Send your .list file by email to destination. Mention in the subject line that your username is a new one.

    You have now finished your part! Your file will be included in the next site update, which usually occurs more often than weekly.

  6. Later, look for your name on the Traveler List.

    Once your file has been processed, your name will appear in this list along with all the other travelers. Click on your username and enjoy your clinched highway stats and maps.

  7. Update your file as needed by emailing an updated copy.

    Check your online Log File (linked on your stats pages). If you included a highway or point label that the mapping script does not recognize, it will tell you in your Log File. Sometimes the highway data are updated, and this may generate a new error. If you do more traveling, you can update your .list file to reflect the new highways on which you have traveled. To update your file, just email it again, and it will be processed in the subsequent site update.

The Clinched Highway Mapping collaborators hope that you enjoy your free maps and stats pages.

Solutions to common problems

  1. An invalid username was chosen.

    Only the characters a-z, 0-9, and the underscore (_) are allowed in usernames. If you used other characters, such as capital letters or non-English characters or symbols, remove them.

  2. The filename does not match the username.

    If the username is highwayguy80, then the filename should be highwayguy80.list, not highwayguy80.txt, HighwayGuy80.list, arkansas.list, motorways.list, nor other filenames. Note that since usernames generally do not change, the valid filename also generally does not change.

    Due to Windows operating systems hiding the file extension .list by default and/or including an extra, hidden .txt extension, a .list.txt extension is also accepted (e.g., highwayguy80.list.txt). However, users are asked to avoid the double extension so that files do not need to be renamed after being submitted.

  3. The file was not emailed.

    Check that you attached your file to the email you thought you sent, and check that the email was sent. Files that are not emailed cannot be processed.

  4. The file was sent but has not yet been processed.

    File processing is not automated at this time, and a few days may pass between receipt of the file and its processing. If your file has not been processed and more than 7 days have passed since you sent the email with the file attached to it, then simply send your file by email once more. If instead, 7 or less days have passed, no action is needed on your part.

    Note that occasionally processing may take place more than 7 days after receipt. If this is the case, a notice will appear on the home page to inform you of the temporary suspension of file processing. Your file will be processed when processing resumes without any further action needed on your part.

  5. The new file was processed, but all the highways from the previous file have vanished.

    The new file should contain all your traveled highways, not just additions to those from a previously submitted file. The new file always replaces the previous file rather than supplementing it. This system allows users to not only add or modify lines in their file but also to delete them as needed.