Upload Waypoints
Note: These instructions apply only if you are using Potlatch to edit map data. Users of JOSM please refer to its documentation.
Contents |
What is a waypoint?
Waypoints are also known as Points of interest (sometimes shortened to "POIs").
They are single points you can log with your GPS device. Waypoints usually mark geographical positions of interesting objects, like:
- a railway station
- a restaurant
- a post box
etc...
How should I label waypoints while mapping?
To distinguish between different waypoints (e.g. between two different restaurants), GPS devices label them with numbers or names. Instead of typing in specific names for every waypoint, we suggest accepting the automatic numbers or names given by the GPS device. While surveying the area, you can write the names of the logged objects on a notepad or dictate them to a voice recorder, as you will have to enter this information in OSM manually later.
How do I add waypoints I recorded to OSM?
You will need to:
- extract the waypoint information from your GPS (e.g. with software like Mapsource)
- save the waypoint information as a GPX file
- upload the GPX file to OSM as a "trace"
- You can then edit your waypoints with Potlatch and permanently add them to the map.
Power users may want to look into JOSM for a one-stop editing and mapping solution.
For the rest of this article, we will focus on #3 and #4. This is not the most elegant of methods, but it's simple and it works.
Preparing to upload the GPX file to OSM
Have you saved your waypoints using your GPS software (e.g. MapSource) in a GPX file?
If so, great! You are one step away from uploading your waypoints to OSM.
The OSM server will reject a GPX file that contains 'waypoints' only. The file must contain at least one 'trackpoint' as well.
Usually, if you've been out surveying with your GPS set, you will have recorded both tracks and waypoints - in which case you can skip the next section. However, if your GPX file includes only waypoints, you need to add a fake trackpoint.
Adding a fake trackpoint
Open the GPX file in a text editor and paste the following text in. The text should go immediately after the line at the start of your GPX file that begins with "<gpx " and ends with a ">".
<trk> <trkseg> <trkpt lat="CHANGE_ME" lon="CHANGE ME"> <time>2009-06-21T15:34:01Z</time> </trkpt> </trkseg> </trk>
Bringing the fake trackpoint close to your waypoints
To make further editing easier, it is a good idea to set the latitude and longitude of the fake trackpoint you just added to be close to your waypoints. To do that, replace the lat="CHANGE_ME" lon="CHANGE ME" of the fake trackpoint with the lat/lon values of one of your waypoints, as shown below:
Now save and close the GPX file. You are ready to upload your waypoints to OSM!
Uploading the waypoints file to OSM
After logging in to the OSM website, you can upload the GPX file you prepared.
Editing in Potlatch
Go to your listing of uploaded tracks ("my traces"), and click the 'edit' link next to the trace as highlighted below:
Potlatch will open, showing the waypoints you just uploaded as little red circles:
You now need to unlock each waypoint by holding "Alt" on your keyboard and clicking on it once. (or ctrl-shift if you're using a system that doesn't allow alt; see Potlatch 2/Shortcuts).
Your waypoint becomes green:
Now you will need to tag your waypoint by giving it a category:
...adding any additional information you have captured about your waypoint:
...and finally saving.
Congratulations, you have just added a new Point of Interest in OSM for everyone to use!
