Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
roadmap(1)							    roadmap(1)

NAME
       roadmap - Street	navigation system using	vector maps and	a GPS receiver

SYNTAX
       roadmap	  [--location=longitude,latitude]    [--metric]	  [--imperial]
       [--no-area]	[--geometry[:window]=widthxheight]	[--no-toolbar]
       [--no-icon]     [--square]    [--gps=url]    [--cache=number]	[--de-
       bug[=source,...]] [--verbose] [--help]

DESCRIPTION
       RoadMap is a program for	UNIX that displays street maps.	The  maps  are
       provided	 for  example  by the US Census	Bureau.	When a GPS receiver is
       available RoadMap can track the current location	of the vehicule	on the
       screen,	continuously  adjusting	 the  position of the map; it can also
       identify	the name of the	current	street as well as the name of the next
       intersection.

       RoadMap	can  be	used without a GPS receiver, as	a static map viewer or
       address finder.

       More information	is available in	the RoadMap online help.

OPTIONS
       Most options may	also be	set as preferences. In fact,  when  an	option
       matches	a  preferences	item, using the	option does modify the prefer-
       ences item as well.  As a consequence the effect	of theses options will
       be  permanent  until  the  same	option is used again or	the associated
       preference item has been	changed.  Because  the	same  preferences  are
       used  by	 roadmap and roadgps, using any	of those options with one pro-
       gram will impact	the other.

       An option with no associated preference item behaves in a  more	tradi-
       tional way, i.e.	its effect is valid for	that command only.

       --location=longitude,latitude
	      Set  the	current	location point (see menu entry View/Show Loca-
	      tion..).	Preference item: Locations.Location.

       --metric
	      Use the metric system for	 all  units.   Preference  item:  Gen-
	      eral.Unit	= metric.

       --imperial
	      Use  the	imperial  system for all units.	 Preference item: Gen-
	      eral.Unit	= imperial.

       --no-area
	      Do not show the polygons (parks,	hospitals,  airports,  etc..).
	      This  option  was	created	for debug purposes and is probably now
	      useless.

       --geometry[:window]=widthxheight
	      Set the geometry of a specific  RoadMap  window,	identified  by
	      it's title. If no	window title is	provided, this defines the ge-
	      ometry of	the main window.  If the window's title	 includes  any
	      space,  dashes can be used in place of the spaces	(the goal here
	      is to be shell friendly).	 Preference item: Geometry.window.

       --no-toolbar
	      Do not show the toolbar.	Preference item: General.Toolbar = no.

       --no-icon
	      Do not show any icon (presumably to keep as much space as	possi-
	      ble for the map).	 Preference item: General.Icons	= no

       --square
	      Show  the	boundaries of the maps index grid (a variant of	the R-
	      Tree index).  This option	is for debug purpose only.

       --trip Open the given tripname on startup.

       --gps=url
	      Use the specified	GPS source. Two	 URL  formats  only  are  sup-
	      ported:  "gpsd://host/"  (access	the GPS	through	a gpsd server)
	      and "file://path"	or "path" (path	must be	a full path).	As  an
	      exception,  this	option is not sticky: it does override the re-
	      lated preferences	item, but the preferences  are	not  modified.
	      The  main	 rational  for this behavior is	to make	it painless to
	      replay GPS logs.

       --cache=number
	      Set the number of	entries	in the roadmap's  map  cache.  To  in-
	      crease  performances,  roadmap  keeps  the  last	used map files
	      mapped in	memory.	This option defines how	many map files can  be
	      mapped  at  a  given  time. The greater this number is, the more
	      system ressources	(virtual memory	page descriptors) roadmap will
	      use.  Preference item: Map.Cache

       --debug[=source,...]
	      Print  debug  messages.  If  a list of source files is provided,
	      only messages generated  from  within  these  source  files  are
	      printed.

       --verbose
	      Enable some log messages (a subset of the	debug messages).

       --help Show a description of the	program	options	and quit.

FILES
       ~/.roadmap/preferences
       /etc/roadmap/preferences
       /usr/share/roadmap/preferences

ENVIRONMENT VARIABLES
       ROADMAP_MAPPATH
	      Specifies	extra paths to use when	looking	for maps.

AUTHORS
       Pascal Martin <pascal.martin@ponts.org>

       This  manual  page  was	written	 by Petter Reinholdtsen	for the	Debian
       package.

SEE ALSO
       gpsd(1) roadgps(1)

Petter Reinholdtsen		     1.0.8			    roadmap(1)

NAME | SYNTAX | DESCRIPTION | OPTIONS | FILES | ENVIRONMENT VARIABLES | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=roadmap&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help