Об этом проекте

Этот репозиторий предоставляет обширный, поддерживаемый сообществом набор данных о странах, штатах, городах и почтовых индексах. Он опубликован в 12 форматах: JSON, MySQL, PostgreSQL, SQLite, SQL Server, MongoDB, XML, YAML, CSV, GeoJSON, TOON (оптимизирован для LLM) и Parquet. Данные включают коды ISO2/ISO3, коды стран, столицы, родные языки, часовые пояса (100% покрытие IANA) и переводы на 19 языков. **Объем данных:** - 6 регионов, 22 субрегиона - 250 стран - 5 299 штатов/регионов/муниципалитетов - 153 765 городов/поселков/районов - 844 248 почтовых индексов (125 стран) - 427 часовых поясов **Варианты использования:** - **REST API** (`api.countrystatecity.in`): запрос данных на любом языке с бесплатным уровнем для прототипирования и платными уровнями для продакшена. Доступен официальный Python-клиент (`countrystatecity-api`). - **Инструмент экспорта** (`export.countrystatecity.in`): создание индивидуальных наборов данных в браузере с выбором полей. - **NPM-пакеты**: `@countrystatecity/countries`, `-browser`, `-currencies`, `-timezones`, `-translations` и CLI. - **PyPI-пакеты**: офлайн-снимки для стран, часовых поясов, валют, переводов, телефонных кодов, регионов и почтовых индексов. - **Прямые загрузки**: сжатые экспорты доступны в каждом релизе GitHub. - **Другие платформы**: браузер баз данных, энциклопедия, менеджер сообщества для исправлений, CLI, Kaggle и Data.world. **Вклад:** - Используйте веб-интерфейс Community Manager для простых исправлений или редактируйте JSON-файлы напрямую в каталогах `contributions/`. - Обязательные поля для новых городов: name, state_id, state_code, country_id, country_code, latitude, longitude. Необязательные: timezone, wikiDataId, native. - Не редактируйте автоматически сгенерированные каталоги; они пересобираются из MySQL при каждом релизе. **Лицензия:** Open Database License (ODbL v1.0). Коммерческое использование, модификация и распространение разрешены с указанием авторства. Производные работы должны распространяться под той же лицензией. **Отказ от ответственности:** Данные, поддерживаемые сообществом, могут содержать ошибки или отставать от геополитических изменений. Проверяйте критически важные данные по официальным источникам.