reverse-geocoding

Reverse-geocoding boundary dataset

Boundary dataset for OpenSAK's offline, fully local reverse-geocoding engine — resolves a cache's coordinates to its country, state/region, and county without any network call or third-party API.

Published via GitHub Releases only — no data files are committed to this repository. The app downloads what it needs directly from Releases.

What's in a release

Each release publishes the following as flat assets (GitHub Release assets cannot hold subdirectories):

boundaries.db          SQLite: per-layer R-Trees + region metadata
manifest.json          dataset + per-pack versions, used for update checks
world.geojson          country-level baseline
<cc>.geojson           state/province level, one file per country (e.g. prt.geojson)
<cc>_<pack>.geojson    county level, one or more files per country, on-demand
                       (e.g. prt_all_prt.geojson, usa_california.geojson)

The exact schema and contract are defined in the main repository:

• docs/reverse-geocoding-data.md — file layout, boundaries.db schema, GeoJSON pack format
• architecture/reverse-geocoding.md — full engine design
• plans/reverse-geocoding-data-migration.md — how this repo plugs into the app

Generated by OpenSAK's own pipeline: tools/boundaries/gsak_to_opensak.py.

How the app uses this

opensak/geo/packs.py downloads the baseline + on-demand county packs from this repository's latest release (DATA_REPO_URL = https://github.com/OpenSAK-Org/OpenSAK-Data/releases/latest/download) and caches them locally — country/state resolution works fully offline after the first run.

License & attribution

Published under the Open Database License (ODbL) v1.0 — see LICENSE at the repository root. Data provenance and the required attribution notice: see ATTRIBUTION.md.