Skip to main content

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. All the cities returned are sorted by the importance of a city and the population density.

Features

  1. fast(less than 0.01s for each searching), 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.

Example

from Cities import cities_retriever
cr = cities_retriever.CitiesRetriever("Sources/dict_1.json")
cities = cr.retrieve_cities(-124.71, -77.21, 25.24, 44.75, 50) # starting longitude, ending longitude, starting latitude, ending latitude, the number of the cities 
print(json.dumps(cities, indent=2))

Note

it might take you a little time(13s for loading the dict) when you first invoke the retrieve method. But the loading process only occurs when you initiate an instance. The retrieving time is still stay around 0.001s ~ 0.01s(it depends on how many cities you want). The mainly time-consuming part in retrieving is a sorting part.

Project details


Download files

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

Source Distribution

Cities-0.7.tar.gz (4.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

Cities-0.7-py2.py3-none-any.whl (4.2 kB view details)

Uploaded Python 2Python 3

File details

Details for the file Cities-0.7.tar.gz.

File metadata

  • Download URL: Cities-0.7.tar.gz
  • Upload date:
  • Size: 4.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for Cities-0.7.tar.gz
Algorithm Hash digest
SHA256 f9d6b8bac4471317ea9151329a25eb6ba3a14e5dd87745d95706e50a1039d573
MD5 69de5071bfba62b95e650f484e5cf26b
BLAKE2b-256 a51c284e13ae5bbb818b04399338ed3253b948e5770e958351b0b1e644b9e551

See more details on using hashes here.

File details

Details for the file Cities-0.7-py2.py3-none-any.whl.

File metadata

  • Download URL: Cities-0.7-py2.py3-none-any.whl
  • Upload date:
  • Size: 4.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.1 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for Cities-0.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 20b2477f8c49396fdc4ff700d37d269b5e831babc36b8b42022337a870257f1d
MD5 7e34e2d22de792b2613370b02ab28e18
BLAKE2b-256 a0dcf951f00a8995e33c0a4eb83ebdeb453130764c522c9a3e31273b0a94059d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page