86Cao/china-city-render

VisNavMap City Offline Render Snapshots

This dataset contains one offline-render cache per city, derived from the matching city-level OpenStreetMap PBF from the Hugging Face dataset `86Cao/china-city-osm-pbf`. It lets VisNavMap render global and local map observations without parsing or querying the source PBF during rollout.

Data provenance

The data-generation chain is:

Hugging Face: 86Cao/china-city-osm-pbf
        │
        │ download city-level <adcode>_<official_name>.osm.pbf
        ▼
VisNavMap offline renderer: build_render_snapshot()
        │
        ▼
city-level GeoPackage: <adcode>_<official_name>.gpkg

The city filename is kept unchanged across the source PBF, GeoPackage, and manifest, allowing each render snapshot to be traced back to its source city. The original PBF files are not duplicated in this dataset.

Contents

data/
  render_snapshot/  # <adcode>_<official_name>.gpkg
  manifests/        # one manifest per city plus index.json

Each GeoPackage is a multi-layer snapshot in EPSG:3857. The standard layers are:

buildings
landuse
natural
roads

The city namespace is aligned with the source PBF and GraphML datasets:

110000_北京市.gpkg
110000_北京市.json

The manifest records the source PBF, checksum, CRS, layer list, and relative snapshot path. data/manifests/index.json is the authoritative city catalog.

Loading

from visnavmap.render import OfflineMapContext

context = OfflineMapContext.from_snapshot(
    "data/china-city-render/data/render_snapshot/110000_北京市.gpkg"
)

At runtime the project uses the matching offline snapshot when present and falls back to PBF-based rendering only when it is absent.

Reproduction

python data/china-city-render/scripts/build_render_snapshots_from_pbf.py \
  --pbf-root data/china-city-osm-pbf/data/pbf \
  --output-root data/china-city-render

The input directory is searched recursively for *.osm.pbf. For each city, the script writes one GeoPackage to data/render_snapshot/, one manifest to data/manifests/, and rebuilds data/manifests/index.json. Existing snapshots are skipped by default; add --overwrite to regenerate them. Add --show-poi when point-of-interest layers are required.

The script depends on the VisNavMap runtime source under src/ and the project's rendering dependencies. It uses the same build_render_snapshot() implementation as training and inference.

Data and licensing

These files are derived from OpenStreetMap data. Preserve OpenStreetMap attribution and comply with the Open Database License (ODbL). The source PBF files are not duplicated in this artifact dataset; obtain them from `86Cao/china-city-osm-pbf`.