Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

file 69 lines (45 sloc) 2.014 kb

Cities

Build Status Code Climate

All the cities of the world (according to the periodically updated MaxMind database).

Data

To use this gem, you'll need the JSON data.

Download it, extract it and connect it up as follows.

$ wget https://s3-us-west-2.amazonaws.com/cities-gem/cities.tar.gz
$ tar -xzf cities.tar.gz
Cities.data_path = '/path/to/cities'

Usage

Countries are identified by their ISO 3166-1 alpha-2 codes.

cities = Cities.cities_in_country('GB')
  #=> { "abberley"=> #<City:0x000001049b9ba0>, "abberton"=> #<City:0x000001049b9b50>, ... }

mcr = cities['manchester']
  #=> #<City:0x00000102fb4ea8>

mcr.name
  #=> "Manchester"

mcr.population
  #=> 395516

mcr.latlong
  #=> [53,5, -2.216667]

The database is exhaustive and certainly stretches the definition of the word "city".

Cities.cities_in_country('GB')['buchlyvie'].population
  #=> 448

Countries

This gem was designed as an extension to the Countries gem. Installing Cities adds two new instance methods to the Country class.

us = Country.search('US')
  #=> #<Country:0x000001020cf5f0>

us.cities?
  #=> true

us.cities
  #=> { "abanda" => #<Cities::City:0x00000114b34a38>, ...  }

Credits

Provided under an MIT license by Joe Corcoran. Thanks to hexorx for the countries gem that brought this idea about.

This product includes data created by MaxMind, available from http://www.maxmind.com. All data © 2008 MaxMind Inc. Read the MaxMind WorldCities open data license for more details.

Something went wrong with that request. Please try again.