Contents

A lightweight geocoder gem that uses Google Maps' geocoder service to return basic information about an address including latitude, longitude, zip code, and formatted Address

## Installation

Add this line to your application's Gemfile:

    gem 'locationator'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install locationator

## Usage

There are 5 methods in this gem:

Return the latitude of an address:

    $ Locationator.lat("800 W. Huron St Chicago, IL")
    => 41.895347

Return the longitude of an address:

    $ Locationator.lng("800 W. Huron St Chicago, IL")
    => -87.648072

Return an array of the latitude and longitude of an address:

    $ Locationator.lat_lng("800 W. Huron St Chicago, IL")
    => [41.895347, -87.648072]

Return the postal (zip) code of an address:

    $ Locationator.zip("800 W. Huron St Chicago, IL")
    => "60642"
    
Return the properly formatted version of an address

    $ Locationator.format("800 W. Huron St Chicago, IL")
    => "800 West Huron Street, Chicago, IL 60642, USA"

## TODOs
1. Find a better way of locating the postal code in Google Maps' JSON response.
2. Find a better way of validating the array generated by the lat_lng method.

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
locationator-0.2.0	README.md
locationator-0.1.2	README.md
locationator-0.1.1	README.md