Find file
Fetching contributors…
Cannot retrieve contributors at this time
39 lines (26 sloc) 1.25 KB


Valid addresses fetcher, aimed to provide random geographical positions near a place, a city or within a country, everything that google maps can understand.

How to

AddressBook.fetch(options) where options is a hash that can contain ( 0 means unlimited ):

  • :min minimal amount of fetched addresses, 0 by default

  • :max maximum amount of fetched addresses, 0 by default

  • :queries an array of queries to select addresses, enough to fetch 90 addresses in Paris by default

  • :referer Google's api always expects a referer ( default “localhost:3000” )

It returns an array of valid addresses.

See spec/address_book_spec.rb for more.


  • mock the specs !

  • an executable to fetch addresses from CLI

  • various outputs format

  • more errors handling

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but

    bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


Copyright © 2009 J.H. Chabran. See LICENSE for details.