Travel Mapping Manual: Highway Data (.wpt) Files

Each route in TM is represented by a highway data file, which we often refer to as a "waypoint file". These files have a .wpt extension.

.wpt Filenames
.wpt Data Format

🔗 One .wpt file is needed for each highway in each region. Highways crossing into multiple subdivisions of a subdivided country (e.g., states in the USA), or crossing into multiple countries (e.g., UNECE International 'E' Roads in Europe) must be chopped at borders into separate files for each region.
🔗 Filenames are entirely lowercase and have a .wpt extension.
🔗 Be sure you can see file extensions in your operating system. Windows hides known file extensions by default, so if you see a ".wpt" extension, the file might actually have something else appended, such as ".wpt.txt". This is no good. In Windows Explorer, you can disable the "Hide extensions for known file types" option in Tools menu > Folder Options > View tab.
🔗 region.route.wpt is the format for the filename.
- 🔗 For undivided countries, the region is the 3-letter ISO alpha-3 country code. See our list on GitHub, which is based on the CIA World Fact Book.
- 🔗 For divided countries (USA, CAN, MEX, GBR, RUS, KAZ), the region is an abbreviation for the subdivision rather than for the country. The USA and CAN use the standard postal codes. GBR (United Kingdom) uses WLS, SCT, ENG, NIR. For other countries, ask about the subdivision codes. Some countries (e.g., MEX) have the country code prepended to avoid collisions with subdivision codes of other countries (NL = Newfoundland and Labrador in Canada , MEX-NL = Nuevo León in Mexico). See our list on GitHub.
- 🔗 The route is a concatenation of 3-digit zero-padded number designation (e.g., a005, us042, pa343, la3132), the banner if applicable (bus, trk), and the 3-letter Abbrev. if applicable (e.g., cat, pit).
- 🔗 Examples:
  - fra.a021.wpt = France A21.
  - pa.pa042trkeag.wpt = Pennsylvania PA 42 Truck (Eagles Mere).
  - grc.a005.wpt = Greece A5 (main piece).
  - grc.a005art.wpt = Greece A5 Arta section.

🔗 The format is simple. Each line as two fields separated by a space.
1. Waypoint label. This identifies the waypoint.
2. OpenStreetMap URL that includes coordinates.

🔗 For example, the first few lines of PA US 11 (pa.us011.wpt) are:

MD/PA http://www.openstreetmap.org/?lat=39.721015&lon=-77.724087
PA163 http://www.openstreetmap.org/?lat=39.721396&lon=-77.724141
I-81(3) http://www.openstreetmap.org/?lat=39.755966&lon=-77.726984
PA16 http://www.openstreetmap.org/?lat=39.791111&lon=-77.731190
PA914 http://www.openstreetmap.org/?lat=39.865200&lon=-77.698738
SocIslRd http://www.openstreetmap.org/?lat=39.873043&lon=-77.687918
GuiSprRd http://www.openstreetmap.org/?lat=39.897681&lon=-77.675327
OrcDr http://www.openstreetmap.org/?lat=39.914143&lon=-77.668498
PA316 http://www.openstreetmap.org/?lat=39.927337&lon=-77.662439
US30 http://www.openstreetmap.org/?lat=39.936539&lon=-77.660417

🔗 No blank or comment lines. The file may end with a final return character.