# GeoNames のスナップショット

[GeoNames](https://www.geonames.org/) のダンプ (https://download.geonames.org/export/dump/) を日付ごとに元のまま残し、Parquet も添えたもの。
上流は毎晩同じ URL の中身を差し替え、版番号もチェックサムも無く、過去の版は有料の購読でしか残らない。

## 出典とライセンス

CC BY 4.0。表示が必要。表示は「GeoNames (https://www.geonames.org/), CC BY 4.0」。詳しくは [LICENSE](LICENSE)。

## スナップショット

ディレクトリ名は、allCountries.zip の Last-Modified の UTC の日付。

| 日付 | geoname の行数 | alternate_names の行数 | allCountries.zip の Last-Modified |
|---|---:|---:|---|
| [2026-10-01/](2026-10-01/) | 13,472,217 | 19,219,062 | Thu, 01 Oct 2026 02:08:51 GMT |

各ディレクトリの中身:

- `raw/`: 落としたファイルをそのまま。allCountries.zip、alternateNamesV2.zip、hierarchy.zip、adminCode5.zip と、小さい表 (admin1CodesASCII.txt、admin2Codes.txt、countryInfo.txt、featureCodes_en.txt、iso-languagecodes.txt、timeZones.txt) と readme.txt。
- `geoname/part-NN.parquet`: allCountries の地名辞書。`geometry` 列 (点、WGS 84) を足した GeoParquet。country_code、geonameid の順に並べ、国の途中では切らずに 512MB 未満の複数ファイルに分けてある。どの国がどのファイルにあるかは manifest.json の `countries` (最初と最後の国コード)。
- `alternate_names.parquet` (alternateNamesV2)、`hierarchy.parquet`、`admin_code5.parquet`。
- `manifest.json`: 各ファイルの Last-Modified、大きさ、sha256 と、出力の行数。

列の名前は readme.txt の列を snake case にしたもの。is_preferred_name などの 4 つの旗は、元の '1' か空を真偽値にしてある。行数は元のテキストの行数と照合してから置いている。

この README と LICENSE は、取得スクリプト (study-geoai-algo-py の scripts/mirror_geonames.py) を流すたびに作り直される。