showmojo / street-address

Port of perl cpan module Geo::StreetAddress::US

DESCRIPTION:¶ ↑

Parses one line street addresses and returns a normalized address object.

This is a near direct port of the of the perl module Geo::StreetAddress::US originally written by Schuyler D. Erle.

For more information see search.cpan.org/~sderle/Geo-StreetAddress-US-0.99/

SYNOPSIS:¶ ↑

Parse United States addresses.

Basic Usage:¶ ↑

require 'street_address'
address = StreetAddress::US.parse("1600 Pennsylvania Ave, Washington, DC, 20500")
address.street # Pennsylvania
address.number # 1600
address.postal_code # 20500
address.city # Washington
address.state # DC
address.state_name # District of columbia
address.street_type # Ave
address.intersection? # false
address.to_s # "1600 Pennsylvania Ave, Washington, DC 20500"
address.to_s(:line1) # 1600 Pennsylvania Ave
StreetAddress::US.parse("1600 Pennsylvania Ave") # nil not a full address

Informal/Loose Parsing¶ ↑

address = StreetAddress::US.parse("1600 Pennsylvania Avenue", :informal => true)
address.number # 1600
address.street # Pennsylvania
address.street_type # Ave
address.to_s # 1600 Pennsylvania Ave

Zip+4¶ ↑

address = StreetAddress::US.parse("5904 Richmond Hwy Ste 340 Alexandria VA 22303-1864")
address.postal_code_ext # 1846

address = StreetAddress::US.parse("5904 Richmond Hwy Ste 340 Alexandria VA 223031864")
address.postal_code_ext # 1846

Gemfile:¶ ↑

To use from your Gemfile:

gem 'StreetAddress', '1.0.3', :require => "street_address"