ROAD(7) Miscellaneous Information Manual ROAD(7)NAME
road, gps - road map of the United States
SYNOPSIS
games/road [ -g ] [ -s scale ]
games/gps
DESCRIPTION
Road displays a road map centered around some specified place in the United States. The data comes from the Census Bureau Tiger Database.
The map is drawn in three shades of grey. Light grey is used for water features such as rivers, streams and lakes. Dark grey is used for
railroads and airports. Black is used for roads. On terminals with ldepth zero, all shades appear black.
Without options, the center of the map is the latitude and longitude specified in the file /lib/sky/here. If the -g option is given, the
center of the map will be the latitude and longitude specified by continually monitoring the end of the file /tmp/gpslog. This file is
written by the GPS satellite receiver program gps. With this option, and with gps running, road becomes a moving map display suitable for
cars or planes.
Keyboard commands
s number
sets the scale of the map to number. The number can be prefixed with + or - to increase/decrease the current scale. Scale 6 is
about one mile across the screen and scale 10 is about ten miles across. Scales 1 through 10 are drawn with maximum detail showing
all roads, trails, rivers, streams and airports. Scales 11 through 14 show highways, rivers, airports and county boundaries.
Scales 15 through 20 show interstate highways and state boundaries.
/regexp
All features labeled by text matching the regular expression are highlighted.
p place
centers the map at the specified place. Usually the place must have the associated state code, (eg murrayhill,nj) but places like
lax and ewr are also known.
l latitude longitude
centers the map at the specified coordinate.
g toggles the -g option described above.
q Exit.
Mouse button commands
Button 1
displays the text of the line nearest the cursor. Normally this is the name of a street or river.
Button 2
displays the text of the place nearest the cursor. Normally this is a town.
Button 3
centers the display on the cursor position.
Gps reads /dev/eia0 assumed connected to a Garmin GPS-55 satellite receiver and writes the current location on the end of the file
/tmp/gpslog. It is intended to be used with mobile PC's.
FILES
/lib/roads/LLLL/LLLLGGGG.h
scale 1-10 database files where LLLL is the latitude multiplied by 5 and GGGG is the longitude multiplied by 5.
/lib/roads/LLL/LLLGGG.h
scale 11-14 database files where LLL is the latitude multiplied by 1 and GGG is the longitude multiplied by 1.
/lib/roads/LL/LLGG.h
scale 15-20 database files where LL is the latitude multiplied by 0.2 and GG is the longitude multiplied by 0.2.
/lib/roads/place
/lib/roads/place.local are the translations between place names and locations. These files must be sorted.
/lib/sky/here
default starting map center.
/tmp/gpslog
moving map location.
SOURCE
/sys/src/games/road
/sys/src/games/gps
ROAD(7)
Check Out this Related Man Page
Net::DNS::RR::LOC(3) User Contributed Perl Documentation Net::DNS::RR::LOC(3)NAME
Net::DNS::RR::LOC - DNS LOC resource record
SYNOPSIS
use Net::DNS;
$rr = new Net::DNS::RR('name LOC latitude longitude altitude size hp vp');
DESCRIPTION
DNS geographical location (LOC) resource records.
METHODS
The available methods are those inherited from the base class augmented by the type-specific methods defined in this package.
Use of undocumented package features or direct access to internal data structures is discouraged and could result in program termination or
other unpredictable behaviour.
latitude
$latitude = $rr->latitude;
($deg, $min, $sec, $ns ) = $rr->latitude;
$rr->latitude( 42.357990 );
$rr->latitude( 42, 21, 28.764, 'N' );
$rr->latitude( '42 21 28.764 N' );
When invoked in scalar context, latitude is returned in degrees, a negative ordinate being south of the equator.
When invoked in list context, latitude is returned as a list of separate degree, minute, and second values followed by N or S as
appropriate.
Optional replacement values may be represented as single value, list or formatted string. Trailing zero values are optional.
longitude
$longitude = $rr->longitude;
($deg, $min, $sec, $ew ) = $rr->longitude;
$rr->latitude( 71.014338 );
$rr->latitude( 71, 0, 51.617, 'W' );
$rr->latitude( '71 0 51.617 W' );
When invoked in scalar context, longitude is returned in degrees, a negative ordinate being west of the prime meridian.
When invoked in list context, longitude is returned as a list of separate degree, minute, and second values followed by E or W as
appropriate.
altitude
$altitude = $rr->altitude;
Represents altitude, in metres, relative to the WGS 84 reference spheroid used by GPS.
size
$size = $rr->size;
Represents the diameter, in metres, of a sphere enclosing the described entity.
hp
$hp = $rr->hp;
Represents the horizontal precision of the data expressed as the diameter, in metres, of the circle of error.
vp
$vp = $rr->vp;
Represents the vertical precision of the data expressed as the total spread, in metres, of the distribution of possible values.
latlon
($lat, $lon) = $rr->latlon;
Returns the latitude and longitude coordinate pair as signed floating-point degrees.
version
$version = $rr->version;
Version of LOC protocol.
COPYRIGHT
Copyright (c)1997 Michael Fuhr.
Portions Copyright (c)2011 Dick Franks.
Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.
All rights reserved.
This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
perl, Net::DNS, Net::DNS::RR, RFC1876
perl v5.18.2 2014-01-16 Net::DNS::RR::LOC(3)