Module v1 

Modules

compressed_ring_segment

Nested message and enum types in CompressedRingSegment.

ring_segment

Nested message and enum types in RingSegment.

Structs

CompressedInlinePoints

CompressedInlinePoints stores a short inline ring segment as polyline bytes.

CompressedPolygon

CompressedRingSegment

CompressedRingSegment mirrors RingSegment with polyline-encoded inline points.

CompressedSharedEdge

CompressedSharedEdge stores a shared boundary edge with its point sequence polyline-encoded (delta + zigzag, same algorithm as CompressedPolygon).

CompressedTimezone

CompressedTimezonesItem designed for binary file as small as possible.

CompressedTimezones

CompressedTopoPolygon

CompressedTopoPolygon mirrors TopoPolygon with compressed ring segments.

CompressedTopoTimezone

CompressedTopoTimezone mirrors TopoTimezone with compressed polygons.

CompressedTopoTimezones

CompressedTopoTimezones combines shared-edge deduplication with polyline coordinate compression. Shared edge point sequences and inline segments are stored as polyline bytes instead of repeated Point messages, significantly reducing file size on top of the deduplication savings. grid_index is an optional embedded 1°×1° candidate-reduction index built at compress time. When present, Finder uses it to skip full linear scans.

GridIndex

GridIndex is the complete 1°×1° candidate-reduction index. Only cells with at least one intersecting timezone are stored.

GridIndexCell

GridIndexCell records the timezone indices that intersect a single 1°×1° cell. tz_indices are 0-based positions into the timezones array of the companion CompressedTopoTimezones (or Timezones) file, matching the order used by Finder.items.

InlinePoints

Wrapper for a sequence of inline points used inside a RingSegment oneof. (proto3 does not allow repeated fields directly in a oneof.)

Point

Basic point data define.

Polygon

Define a polygon, mostly based on GeoJSON’s Polygon define.

PreindexTimezone

PreindexTimezone tile item.

PreindexTimezones

PreindexTimezones is all preindex timezone’s dumps.

RingSegment

A ring segment: either inline points or a reference to a shared edge. Shared edges are stored once in TopoTimezones.shared_edges and referenced by their index; edge_reversed references the same edge but traversed in the opposite direction.

SharedEdge

A shared boundary edge stored once in the global edge library. Rings reference it by index (forward or reversed) instead of repeating the point sequence.

Timezone

Timezone is a timezone’s all data.

Timezones

TopoPolygon

A timezone polygon in topology format. The exterior ring is represented as an ordered sequence of segments. Holes are nested TopoPolygons.

TopoTimezone

A timezone in topology format.

TopoTimezones

Timezones in topology format with shared-edge deduplication. Shared timezone boundaries are stored exactly once in shared_edges; rings reference them by ID rather than duplicating the point sequences. This format targets full-precision data where ~52% of boundary edges are shared, reducing the 96 MB full dataset by ~30–35 MB.

Enums

CompressMethod