1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
|
\" =========================================================================
\" llsearch.1 - The manual page for the llsearch program.
\" Copyright (c) 1997 Fred M. Erickson
\"
\" This program is free software; you can redistribute it and/or modify
\" it under the terms of the GNU General Public License as published by
\" the Free Software Foundation; either version 2, or (at your option)
\" any later version.
\"
\" This program is distributed in the hope that it will be useful,
\" but WITHOUT ANY WARRANTY; without even the implied warranty of
\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\" GNU General Public License for more details.
\"
\" You should have received a copy of the GNU General Public License
\" along with this program; if not, write to the Free Software
\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
\" =========================================================================
.TH LLSEARCH 1 \" -*- nroff -*-
.SH NAME
llsearch \- Search a GNIS file for place names within a given block of latitude/longitude
.SH SYNOPSIS
.B llsearch
latitude_low longitude_low latitude_high longitude_high
.SH DESCRIPTION
The U.S. Geological Survey supports sites on the Internet with
Geographic Names Information System (GNIS) files.
These files contain lists of place names, complete with their latitude/longitude and other information.
There is generally one file per U.S. state, and each file contains many, many, many place names.
If you want to use this data with
.I drawmap,
it is useful to reduce the data to only the items that you need.
.I Llsearch
lets you filter a GNIS file and winnow out only those place names that fall within
the latitude/longitude boundaries that you specify.
Latitudes and longitudes are positive for north latitude and east longitude, and negative
for south latitude and west longitude.
.I Llsearch
expects them in decimal degrees.
(The latitudes and longitudes in the GNIS file are in degrees-minutes-seconds format, followed
by 'N', 'S', 'E', or 'W'.)
Typical usage is as follows:
.TP
gunzip -c california.gz | llsearch 33 -118 34 -117 > gnis_santa_ana_west
|
