À propos du projet

Ce dépôt fournit un ensemble de données complet et maintenu par la communauté, couvrant les pays, les états, les villes et les codes postaux. Il est publié en 12 formats : JSON, MySQL, PostgreSQL, SQLite, SQL Server, MongoDB, XML, YAML, CSV, GeoJSON, TOON (optimisé pour les LLM) et Parquet. Les données incluent les codes ISO2/ISO3, les codes pays, les capitales, les langues natives, les fuseaux horaires (couverture IANA à 100 %) et des traductions en 19 langues. **Volume de données :** - 6 régions, 22 sous-régions - 250 pays - 5 299 états/régions/municipalités - 153 765 villes/communes/districts - 844 248 codes postaux (125 pays) - 427 fuseaux horaires **Options d'utilisation :** - **API REST** (`api.countrystatecity.in`) : Interrogez les données depuis n'importe quel langage, avec un niveau gratuit pour le prototypage et des niveaux payants pour la production. Un client Python officiel est disponible (`countrystatecity-api`). - **Outil d'exportation** (`export.countrystatecity.in`) : Créez des ensembles de données personnalisés dans le navigateur avec une sélection de champs personnalisée. - **Paquets NPM** : `@countrystatecity/countries`, `-browser`, `-currencies`, `-timezones`, `-translations`, et un CLI. - **Paquets PyPI** : Instantanés hors ligne pour les pays, fuseaux horaires, devises, traductions, indicatifs téléphoniques, régions et codes postaux. - **Téléchargements directs** : Exportations compressées (gzip) disponibles à chaque version GitHub. - **Autres plateformes** : Navigateur de base de données, encyclopédie, gestionnaire communautaire pour les corrections, CLI, Kaggle et Data.world. **Contribution :** - Utilisez l'interface web du gestionnaire communautaire pour des corrections faciles, ou modifiez directement les fichiers JSON dans les répertoires `contributions/`. - Champs requis pour les nouvelles villes : nom, state_id, state_code, country_id, country_code, latitude, longitude. Facultatifs : timezone, wikiDataId, native. - Ne modifiez pas les répertoires générés automatiquement ; ils sont reconstruits à partir de MySQL à chaque version. **Licence :** Licence Open Database (ODbL v1.0). Utilisation commerciale, modification et redistribution autorisées avec attribution. Les dérivés doivent être partagés sous la même licence. **Avertissement :** Les données maintenues par la communauté peuvent contenir des erreurs ou accuser un retard par rapport aux changements géopolitiques. Vérifiez les données critiques auprès de sources officielles.