Skip to content

ringsaturn/tzf-dist

Repository files navigation

tzf-dist

Binary data distribution for tzf and tzf-rs.

If you have any questions or suggestions, please open an issue in the upstream tzf repository.

Files

File Format Size Description
combined-with-oceans.compress.topo.bin CompressedTopoTimezones ~17MB Full precision: shared-edge dedup + polyline compression
combined-with-oceans.topology.compress.topo.bin CompressedTopoTimezones ~5.4MB Lite: topology-aware simplify + shared-edge dedup + polyline compression
combined-with-oceans.reduce.preindex.bin PreindexTimezones ~2MB Tile pre-index for FuzzyFinder

You can view the file in tzf-bin-viewer once you download it.

The underlying data structures are defined in the tzinfo.proto.

Branch structure

  • main — source code, workflows, and embed.go template; never tagged
  • data — latest generated binaries as an orphan commit (force-pushed on each update); the tip commit is what gets tagged for releases

Historical data is accessible via tags — each tag points to a single orphan commit on data that contains the binary files for that timezone-boundary-builder version.

Usage (Go module)

Import a tagged version (tags point to data branch commits containing the embedded files):

import tzfdist "github.com/ringsaturn/tzf-dist"

// tzfdist.CompressTopoData        — full precision CompressedTopoTimezones
// tzfdist.TopologyCompressTopoData — lite CompressedTopoTimezones
// tzfdist.PreindexData             — tile pre-index

Usage (Rust crate)

[dependencies]
tzf-dist = "..."

If you need full data precision, use the full feature flag with git based dependency(full data is not available on crates.io due to size constraints):

[dependencies]
tzf-dist = { git = "https://github.com/ringsaturn/tzf-dist", tag = "...", features = ["full"], default-features = false}

Releases

Binary files are attached to each GitHub Release as assets, built from the corresponding timezone-boundary-builder release.

Tags are created manually from the data branch tip after automated data generation. Creating a GitHub Release from a tag triggers asset upload via the release workflow.

License

Code is licensed under the MIT License. See LICENSE for details.

Data is licensed under ODbL. See DATA_LICENSE for details. Same with the timezone-boundary-builder.

About

Binary data distribution for tzf

Resources

License

MIT, ODbL-1.0 licenses found

Licenses found

MIT
LICENSE
ODbL-1.0
LICENSE_DATA

Stars

Watchers

Forks

Contributors