GeoList is a very simple ruby gem to get a list of all countries, cities and suburbs.
Install
gem 'geolist', '~> 0.1.0'Examples
List of countries:
GeoList.countries
# [{:name=>"Australia", :alpha2=>"AU", :alpha3=>"AUS"}, ...]List of cities:
GeoList.cities('Australia')
# => ["Adak", "Akhiok", "Akiachak", "Akiak", "Akutan", "Alakanuk", ...]List of suburbs (only for Hong Kong):
GeoList.suburbs('Hong Kong')
# ["Aberdeen", "Causeway Bay", "Central District","Cha Kwo Ling", "Chai Wan Kok", "Chek Chue", ...]Simplified syntax with get method:
-
GeoList.get: list of countries (equivalent to
GeoList.countries) -
GeoList.get(country): list of cities (equivalent to
GeoList.cities(country)) -
GeoList.get(country, city): list of suburbs (equivalent to
GeoList.suburbs(city))
Geo data update
GeoList.update_data
# Will update data file to the latest version (using MaxMind free databases)
# Can be added to migration or in some scheduler
# Database is updated weekly, every Tuesday.