RoadMap: Difference between revisions

From OLPC
Jump to navigation Jump to search
(added screenshot link, minor otherwise.)
(removed uninformative comment on top)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Olpcboxtop|toptext=[[{{PAGENAME}}|RoadMap]]}}
{{Olpcboxtop|toptext=[[{{PAGENAME}}|RoadMap]]}}
{{ OBX activity | [[Image:RoadMap.svg|40px]]|extra}}
{{ OBX activity | [[Image:RoadMap.svg|40px]]|extra}}
{{OBX xobundle | 1=http://dev.laptop.org/~pgf/bundles/RoadMap-1.xo}}
{{OBX xobundle | 1=http://dev.laptop.org/~pgf/bundles/RoadMap-3.xo}}
{{ OBX team |[[User:pgf|Paul Fox]]}}
{{ OBX team |[[User:pgf|Paul Fox]]}}
{{Olpcboxbottom}}
{{Olpcboxbottom}}

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


RoadMap is a street navigation program with roughly the featureset
RoadMap is a street navigation program with roughly the featureset
Line 28: Line 26:


== Screenshots ==
== Screenshots ==

There are currently no screenshots of RoadMap running on the XO, but it runs
Below you can find sceenshots of the RoadMap activitiy running on an XO.
on many other platforms. "Action shots" on some of those can be found

[http://roadmap.sourceforge.net/screenshots.html on the SourceForge screenshots page].
{|style="border: solid 1px gray; margin: 1em auto 1em; auto"
|-
| valign="top"|
[[Image:roadmap_xo_2.png|300px|thumb|center]]
| valign="top"|
[[Image:roadmap_xo_1.png|300px|thumb|center]]
|}

"Action shots" running on other platforms can be found [http://roadmap.sourceforge.net/screenshots.html on the SourceForge screenshots page].


== Operation ==
== Operation ==
Line 55: Line 62:
will search in "/media/*/RoadMap.maps".
will search in "/media/*/RoadMap.maps".


So if you download maps from http://roadmap.sourceforge.net/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
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.
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
As an example -- I have maps for several New England states loaded
on my XO. My SD card contains:
on my XO. My SD card contains:


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

If you're using the OSM quadtile maps, the "Find by Address"
and "Find by Intersection" menu entries will _not_ work.
Only "Find by Position".


GPS --
GPS --


As provided, RoadMap will access your USB-connected GPS device
If you have a GPS device and want RoadMap to use it, you'll want
directly. For most such devices, this will work fine, as long
to install gpsd to help: "yum install gpsd".
as the GPS device is the first serial USB device that your system

If, instead, you'd prefer to access your GPS via the raw tty
discovers (which is to say, as long as your GPS is on /dev/ttyUSB0).
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
If you'd prefer to use the free "gpsd" daemon to manage the
GPS, then you'll want to install gpsd with "yum install
every update of your XO's system software.)
gpsd", and change the method under File --> Preferences -->
GPS --> Source to "gpsd2://localhost".


== Contributors ==
== Contributors ==
RoadMap's home page is [http://roadmap.sourceforge.net here]. Originally
RoadMap's home page is [http://roadmap.sourceforge.net here]. Originally
written by Pascal Martin, RoadMap is currently by maintained by Paul Fox
written by Pascal Martin, RoadMap is currently maintained by Paul Fox
and other contributors to the RoadMap mailing list.
and other contributors to the RoadMap mailing list.


Line 119: Line 126:
}}
}}
{{Activity bundle
{{Activity bundle
|bundle URL=http://dev.laptop.org/~pgf/bundles/RoadMap-1.xo
|bundle URL=http://dev.laptop.org/~pgf/bundles/RoadMap-3.xo
|activity version=1
|activity version=1
|releases=Candidate
|releases=Candidate
}}
}}

[[category:maps]]
[[category:geography]]

Latest revision as of 13:56, 18 March 2009

RoadMap.svg
.xo BundleRoadMap.xo

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.

Roadmap xo 2.png
Roadmap xo 1.png

"Action shots" running on other platforms can be found on the SourceForge screenshots page.

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/

If you're using the OSM quadtile maps, the "Find by Address" and "Find by Intersection" menu entries will _not_ work. Only "Find by Position".

GPS --

As provided, RoadMap will access your USB-connected GPS device directly. For most such devices, this will work fine, as long as the GPS device is the first serial USB device that your system discovers (which is to say, as long as your GPS is on /dev/ttyUSB0).

If you'd prefer to use the free "gpsd" daemon to manage the GPS, then you'll want to install gpsd with "yum install gpsd", and change the method under File --> Preferences --> GPS --> Source to "gpsd2://localhost".

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-3.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: