Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Cities is a simple tool for searching cities located at a given longitude and latitude range.

Project description

Cities is a simple tool for searching cities located at a given longitude and latitude range or a given region(country, state, province). All the cities returned are sorted by the importance of a city and the population density.


pip install Cities


  1. fast(less than 0.01s for each retrieving), simple and convenient.
  2. cover all the cities around the world.
  3. the author is cute.

Required File

Download the city data and put it at any directory you want. Remember to set the path up when you initiate an instance.


from Cities import cities_retriever

cr = cities_retriever.CitiesRetrieverByRect("Sources/dict_all_cities_rect2cities.json")
cities = cr.retrieve_cities(lon_start=-124.71, lon_end=-77.21, lat_start=25.24, lat_end=44.75, num=500) # num is optional, default: 999999

cr = cities_retriever.CitiesRetrieverByRegionName("Sources/dict_all_cities_region2cities.json")
cities = cr.retrieve_cities(country="United States", region="Washington", num=500) # region and num are optional


the bigger the dict file is, the longer the loading time is.

4million cities --- 12s

  1. dict_all_cities_region2cities.json
  2. dict_all_cities_rect2cities.json

8000 cities --- < 1s

  1. dict_cities_8000_region2cities.json
  2. dict_cities_8000_rect2cities.json

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Cities, version 1.1
Filename, size File type Python version Upload date Hashes
Filename, size Cities-1.1-py2.py3-none-any.whl (6.1 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size Cities-1.1.tar.gz (5.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page