NAME

Geo::USCensus::Geocoding - The U.S. Census Bureau geocoding service

VERSION

Version 0.01

SYNOPSIS

use Geo::USCensus::Geocoding;

my $request = {
  # required fields
  street  => '123 Main Street',
  city    => 'San Francisco',   # city
  state   => 'CA',              # state
  # optional fields
  zip     => '93102',           # zip code
  benchmark => 'Public_AR_ACS2013', # default is "Public_AR_Current"
  vintage   => 'Census2010_ACS2013', # default is "Current_Current"

  debug => 1,                   # will print the URL and some other info
};
my $result = Geo::USCensus::Geocoding->query($request);

if ($result->is_match) {
  print $result->address,"\n",
        $result->latitude,", ",$result->longitude,"\n",
        $result->censustract,"\n";
} else {
  print "No match.\n";
}

CLASS METHODS

query HASHREF

Send a request to the web service. See http://geocoding.geo.census.gov/geocoder for API documentation. This package will always use the batch method (which seems to be more reliable, as of 2015) and the Geographies return type.

Returns an object of class Geo::USCensus::Geocoding::Result.

AUTHOR

Mark Wells, <mark at freeside.biz>

SUPPORT

Commercial support for this module is available from Freeside Internet Services:

L<http://www.freeside.biz/>

LICENSE AND COPYRIGHT

Copyright (C) 2014 Mark Wells.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.