RoadMap: Difference between revisions

From OLPC
Jump to navigation Jump to search
Line 31: Line 31:
Below you can find sceenshots of the RoadMap activitiy running on an XO. "Action shots" running on other platforms can be found [http://roadmap.sourceforge.net/screenshots.html on the SourceForge screenshots page].
Below you can find sceenshots of the RoadMap activitiy running on an XO. "Action shots" running on other platforms can be found [http://roadmap.sourceforge.net/screenshots.html on the SourceForge screenshots page].


[[Image:roadmap_xo_2.png|left|thumb|200px]]
[[Image:roadmap_xo_2.png|thumb|200px]]
[[Image:roadmap_xo_1.png|left|thumb|200px]]
[[Image:roadmap_xo_1.png|thumb|200px]]


== Operation ==
== Operation ==

Revision as of 11:52, 7 September 2008

RoadMap.svg
.xo BundleRoadMap.xo

RoadMap is a fast paced, action packed, uh. no. wrong program.

RoadMap is a street navigation program with roughly the featureset of a commercial GPS unit from the year 1999.

Background

RoadMap started life as a rendering engine for the free US Census Bureau Tiger maps. Over time, it has gained support for certain specific shapefile-based mapsets (e.g. Canada, and the Digital Charts of the World, and also now has support for OpenStreetMap data.

Since none of the data available to RoadMap currently includes the meta-data (turn restrictions, one-way information, etc) needed to allow auto-navigation, RoadMap currently doesn't support that feature, though it is common in commercial GPS units. A fork project from RoadMap _does_ include auto-navigation, because it is also capable of creating maps which include that meta-data. Known as the "RoadMap Editor" branch, it is the code behind the Freemap Israel site. Unfortunately, the two codebases have drifted apart. There is an effort underway currently to bring some of the editing and navigation features back to RoadMap.

Screenshots

Below you can find sceenshots of the RoadMap activitiy running on an XO. "Action shots" running on other platforms can be found on the SourceForge screenshots page.

Roadmap xo 2.png
Roadmap xo 1.png

Operation

The up/down/left/right arrow keys will pan around on the map.

The O and X keys zoom in and out, respectively.

The square key will recenter you on the GPS location (if any), and the check key will recenter you on your current route's destination waypoint (if any).

Maps --

The RoadMap activity on the XO is packaged with nothing but a set of US state outline maps, plus a detailed map of the city of San Francisco (which is a nice looking, and doesn't take much space). (That's all I have that's easy to package -- my apologies to the rest of the world!)

RoadMap on the XO will attempt to find maps from the activity bundle directory itself, and also from _any_ directory called "RoadMap.maps" on an installed removeable device. i.e. it will search in "/media/*/RoadMap.maps".

So if you download maps from http://roadmap.sourceforge.net/maps.html, or if you run buildmap_osm to fetch OpenStreetMap maps, you should put them under RoadMap.maps on your SD card or on a USB memory stick.

(As an example -- I have maps for several New England states loaded on my XO. My SD card contains:

   $ ls /media/d0a9...ee70/RoadMap.maps
   ct/ ma/ me/ nh/ ri/ usdir.rdm vt/

GPS --

If you have a GPS device and want RoadMap to use it, you'll want to install gpsd to help: "yum install gpsd".

If, instead, you'd prefer to access your GPS via the raw tty device, RoadMap will need to be able to open /dev/ttyUSB0 to read your gps device. In that case, you'll need to make that device world readable, by adding the following line to a udev config file:

   # cat /etc/udev/rules.d/99-local-ttyUSB0.rules:
   KERNEL=="ttyUSB0", NAME="%k", GROUP="root", MODE="0666"

(You'll need to do this, or the "yum install gpsd" above, after every update of your XO's system software.)

Contributors

RoadMap's home page is here. Originally written by Pascal Martin, RoadMap is currently maintained by Paul Fox and other contributors to the RoadMap mailing list.

If you wish to help, please join the mailing list! If you wish to rebuild the activity bundle, for whatever reason, start with the CVS version of RoadMap from sourceforge. Simply cd into the "sugar" directory and run the "mk_activity" script that you'll find there. If you come up with improvements (which probably won't be hard), please send feedback.

Technical notes

To Do

Download of OpenStreetMap maps without needing an external program would be nice.

UTF-8 labeling of streets would make the author look far less provincial.

We can't seem to find our way to auto-navigation. Currently none of the datasets from RoadMap gets its maps has the metadata needed for navigation.

See the RoadMap home page for a lot more information.

Comments, Suggestions, Requests

Feel free to leave comments, but if you'd like to participate more fully, please subscribe to the RoadMap mailing list.

Activity Summary

Icon: Sugar icon::Image:RoadMap.svg
Genre: Activity genre::Other
Activity group: ,|x|Activity group::x}}
Short description: Short description::RoadMap is a GPS-enabled street navigation program.
Description:
Maintainers: ,|x|Contact person::x}}
Repository URL:
Available languages: ,|x|Available languages::x}}
Available languages (codes): ,|x|Language code::x}}
Pootle URL:
Related projects: Related projects,|x|Related projects::x}}
Contributors: ,|x|Team member::x}}
URL from which to download the latest .xo bundle Activity bundle::
Last tested version number:
The releases with which this version of the activity has been tested. ,|x|Software release::x}}
Development status: Devel status::5. Production-stable
Ready for testing (development has progressed to the point where testers should try it out): ,|x|Ready for testing::x}}
smoke tested :
test plan available :
test plan executed :
developer response to testing :


URL from which to download the last .xo bundle that works with old releases Activity bundle::http://dev.laptop.org/~pgf/bundles/RoadMap-1.xo
Activity version number: Activity version::1
The releases with which this version of the activity has been tested. ,|x|Software release::x}}
Development status: