Что это такое?
Административно-территориальное деление Китая на пяти уровнях — провинции, города, уезды, посёлки и деревни — с официальным статистическим кодом и названием для каждой единицы. Данные представлены в виде файлов JSON, CSV и SQLite.
Это библиотека, которую нужно устанавливать, или просто файлы с данными?
Просто данные, а не библиотека: по одному плоскому файлу JSON и CSV на каждый уровень, плюс связанные каскадные файлы и база данных data.sqlite. Ничего устанавливать не нужно, зависимостей нет.
Как мне получить эти данные?
Скачайте файлы JSON или CSV для нужных уровней прямо из репозитория или заберите полный архив со страницы Releases. Все данные также доступны в виде готового файла data.sqlite.
Нужен ли мне Node.js или какая-нибудь другая среда выполнения?
Нет — обычные файлы JSON, CSV и SQLite можно читать из любого языка или инструмента. Node.js нужен только для запуска собственных скриптов загрузки и сборки из репозитория.
Данные ещё обновляются?
Нет — данные заморожены на редакции 2023 года (по состояние на 30 июня 2023 года), потому что Национальное статистическое управление Китая в октябре 2024 года прекратило публиковать коды административно-территориального деления, поэтому более новых данных нет.
Откуда взяты эти данные?
Из Национального статистического управления Китая — это его коды статистического деления и коды классификации город-село, на которых основана вся государственная статистика. Репозиторий повторяет их редакцию 2023 года.
Как связаны между собой пять уровней?
Каждая запись содержит 12-значный код и коды всех родительских уровней (provinceCode, cityCode, areaCode, streetCode), а каскадные файлы объединяют от двух до четырёх уровней (pc, pca, pcas) в двух версиях — обычной и с пометками кодов. Готового каскада сразу на пять уровней нет.
Эти коды — то же самое, что почтовые индексы?
Нет — это коды статистического деления от Национального статистического управления, а не почтовые индексы. Коды иерархические: код каждого уровня продолжает код родительского, поэтому каскадные файлы так удобно вкладываются друг в друга.
Что обычно делают с этим набором данных?
Чаще всего — каскадные селекторы адреса: выбираешь провинцию, затем город, район, посёлок и деревню — для веб- или мобильных форм. Также данные используют там, где нужны официальные коды деления: для чистки адресов или агрегации статистики по регионам.
What are similar projects?
exercises-dataset, datasette, real-api-pricing, prediction-market-analysis, COVID-19, drawdb, redash, orm