Geo::Fips55--3pm

Fips55(3pm)           User Contributed Perl Documentation          Fips55(3pm)



NAME
       Geo::Fips55 - Perl extension for parsing FIPS-55 gazetteer data

SYNOPSIS
         use Geo::Fips55;

         @records = Geo::Fips55->parse_file( $filehandle );

         Geo::Fips55->parse_file( $filehandle, \&callback );

         $record = Geo::Fips55->new( \%data );

         $record->state_fips();
         $record->place_fips();
         $record->state();
         $record->num_counties();
         $record->crsn();
         $record->class();
         $record->name();
         $record->county_fips();
         $record->county();
         $record->part_of();
         $record->other_name();
         $record->zip();
         $record->postal_match();
         $record->zip_range();
         $record->gsa();
         $record->mrf();
         $record->msa();
         $record->cd1(); # and so on up to cd14()

DESCRIPTION
       Geo::Fips55 provides a representation of the US Geological Survey
       FIPS-55 gazetteer format.  Each object is one record.  It also contains
       methods to parse FIPS-55 data files and turn them into objects.

       This is intended as an intermediate format between pulling the raw data
       out of the simplistic FIPS-55 data files into something more sophisti-
       cated (a process you should only have to do once).  As such, its not
       very fast, but its careful, easy to use and performs some verifications
       on the data being read.

       This module subclasses Michael Schwern's very nice Geo::TigerLine mod-
       ules to do all the heavy lifting.

BUGS, CAVEATS, ETC.
       This module wasn't automatically generated like the Geo::Tiger-
       Line::Record::* modules were. Probably it should have been, but the
       FIPS data record layout changes even less often than the TIGER data --
       the last revision to the FIPS-55 spec was in 1994. If it ever gets
       revised, I will gladly update this module by hand.

SEE ALSO
       You can learn more about the FIPS-55 standard and download the entire
       US geographic names database from <http://geon-
       ames.usgs.gov/fips55.html>.

       Geo::TigerLine(3pm)

AUTHOR
       Schuyler D. Erle <schuyler AT nocat.net>

COPYRIGHT AND LICENSE
       Copyright (C) 2004 by Schuyler D. Erle

       This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself, either Perl version 5.8.3 or, at
       your option, any later version of Perl 5 you may have available.



perl v5.8.7                       2004-05-14                       Fips55(3pm)