Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Python library to look up timezone from coordinates offline. Light version of "timezonefinder".

Project description

timezonefinderL is the faster and lightweight version of the original timezonefinder. The data takes up 9MB (instead of 19,5MB as with timezonefinder). Around 56% of the coordinates of the timezone polygons have been simplified and around 60% of the polygons (mostly small islands) have been included in the simplified polygons.

NOTE: In contrast to timezonefinder with this package the borders of a timezone are stored simplified when there is no directly neighbouring timezone. So on shorelines the polygons look a lot different now! This consequently means that the functions certain_timezone_at() and closest_timezone_at() are not really useful any more!

Check out the GUI and API at: TimezonefinderL GUI

For everything else please refer to the DOCUMENTATION.

Of course the commands need to modified:

pip install timezonefinderL
from timezonefinderL import TimezoneFinder

Also see: GitHub. PyPI


timezonefinderL is distributed under the terms of the MIT license (see LICENSE.txt).

Speed Comparison

shapely: ON (tzwhere)
Numba: ON (timezonefinderL)

TIMES for  10000 realistic points
tzwhere: 0:00:00.608965
timezonefinder: 0:00:00.564314
0.08 times faster

TIMES for  10000 random points
tzwhere: 0:00:00.650164
timezonefinder: 0:00:00.508654
0.28 times faster


2.0.1 (2017-04-08)

  • added missing package data entries (2.0.0 didn’t include all necessary .bin files)

2.0.0 (2017-04-07)

  • introduction of this version of timezonefinder
  • data has been simplified which affects speed and data size. Around 56% of the coordinates of the timezone polygons have been deleted and around 60% of the polygons (mostly small islands) have been included in the simplified polygons. For any coordinate on landmass the results should stay the same, but accuracy at the shorelines is lost. This eradicates the usefulness of closest_timezone_at() and certain_timezone_at() but the main use case for this package (= determining the timezone of a point on landmass) is improved.
  • has been complemented and modified to perform those simplifications
  • introduction of new function get_geometry() for querying timezones for their geometric shape
  • added shortcuts_unique_id.bin for instantly returning an id if the shortcut corresponding to the coords only contains polygons of one zone
  • data is now stored in separate binaries for ease of debugging and readability
  • polygons are stored sorted after their timezone id and size
  • timezonefinder can now be called directly as a script (experimental with reduced functionality, see readme)
  • optimisations on point in polygon algorithm
  • small simplifications in the helper functions
  • clarification of the readme
  • clarification of the comments in the code
  • referenced the new conda-feedstock in the readme
  • referenced the new timezonefinder API/GUI

for older versions refer to timezonefinder.

Project details

Release history Release notifications

This version
History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
timezonefinderL-2.0.1-py2.py3-none-any.whl (7.1 MB) Copy SHA256 hash SHA256 Wheel 3.6 Apr 8, 2017
timezonefinderL-2.0.1.tar.gz (7.1 MB) Copy SHA256 hash SHA256 Source None Apr 8, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page