# Offline place catalog — 2026-09-30

156,211 cities/towns and 1,246 attractions; 244 country/territory codes. Coverage is broad, not exhaustive. Local JSON contains names, administrative labels and point coordinates, not park boundaries or descriptions. New small places are background labels only at maximum offline zoom (8); saved route stops remain visible at other zoom levels. Label collision avoidance still applies.

## Cities and towns

Existing GeoNames catalog: https://www.geonames.org/ — CC BY 4.0. Administrative labels also use GeoNames admin1CodesASCII.txt and Natural Earth public-domain subdivisions.

Additional data by Countries States Cities Database: https://github.com/dr5hn/countries-states-cities-database — ODbL 1.0, https://opendatacommons.org/licenses/odbl/1-0/. Snapshot distributed in country-state-city 3.2.1, https://github.com/harpreetkhalsagtbit/country-state-city (2023 release). Only its data arrays are used; no library code is included. The modified city database is supplied in full as assets/cities.min.json and can be redistributed under ODbL 1.0 with source attribution. Build script and source hashes are included. This database license does not describe the app code.

## Attractions (separate file)

UNESCO World Heritage Centre / UNESCO Datahub, WHC001: https://data.unesco.org/explore/assets/whc001/ — CC BY-SA 4.0, https://creativecommons.org/licenses/by-sa/4.0/. Downloaded 2026-09-30. Names/coordinates/country codes only; modified to add search aliases and region labels. No UNESCO prose or photographs are included.

Wikidata: https://www.wikidata.org/ — CC0. Requested natural attractions use their published P625 coordinates and English/Chinese labels. Yellowstone Q351; Glacier National Park Q373567; Great Geysir Q216846; Strokkur Q1128186, plus selected travel landmarks.

Modified attractions are supplied in full as assets/attractions.min.json under CC BY-SA 4.0. Coordinates represent searchable points; extensive parks can be displayed at their representative point rather than an entrance. Runtime search and offline rendering require no external API.

Row format: [id, name, countryISO2, latitude, longitude, ChineseName, aliases, populationOrImportance, adminShort, adminChinese, placeKind, adminName]. Legacy eight-column rows remain accepted. Do not derive personal trip data from this source catalog.

## Eight-language city names — 2026-11-14

The existing 156,211 city/town IDs, coordinates, population values and row order are preserved. Additional localized names and current search aliases come from the official GeoNames bulk exports: [cities500.zip](https://download.geonames.org/export/dump/cities500.zip), [alternateNamesV2.zip](https://download.geonames.org/export/dump/alternateNamesV2.zip), and [countryInfo.txt](https://download.geonames.org/export/dump/countryInfo.txt), under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). The [GeoNames format documentation](https://download.geonames.org/export/dump/readme.txt) describes language tags and preferred, short, colloquial and historic name flags. This enrichment is modified GeoNames data; no translation service or runtime geocoding API is involved.

Rows may now have a thirteenth field, a locale-to-name object keyed by `en`, `zh`, `ja`, `fr`, `de`, `es`, `it`, and `pt`. Search additionally retains source primary/ASCII names, original aliases and current names in each country's native languages. Historic-only records are excluded from new additions. Chinese labels use simplified characters, and original traditional spellings remain searchable. Country labels and country qualifiers use the browser's native `Intl.DisplayNames` data for all eight UI languages.

The join requires the same country plus a name/alias match within 5 km, or coordinates within 150 m for a renamed place. It matches 132,522 existing city rows to 130,893 GeoNames records. GeoNames is community-maintained, and small settlements do not all have eight distinct translated names. A missing locale name falls back to the existing city name; this is broad multilingual coverage, not a claim that every settlement has a verified translation in every language. See `city-languages-build.json` for exact coverage, source hashes, build policy and byte size.

Reproduce with Python 3, build-only `opencc-python-reimplemented==0.1.7`, the four GeoNames source files listed in `tools/build_city_languages.py`, and `python tools/build_city_languages.py --source-dir SOURCE_DIRECTORY`. The optional `--input` selects a preserved original catalog and `--build-deps` locates an isolated Python dependency folder. OpenCC `t2s` converts the source Chinese character forms; original names remain in aliases. [OpenCC](https://github.com/BYVoid/OpenCC) / [opencc-python](https://github.com/yichen0831/opencc-python) are Apache 2.0; the license is included in `CITY_NAME_CONVERSION_LICENSE.txt`. Neither library nor its dictionaries are needed or loaded by the app.

## Antarctica destination addition
`destination:antarctica`: continent-wide travel destination, AQ, representative map anchor 75 S / 0 E (not a city or actual landing location). English and Chinese names plus multilingual search aliases. Reference: https://mapcarta.com/Antarctica .
