Comprehensive Brazilian state codes information, including ISO 3166-2:BR codes (the official 2-letter code abbreviations), IBGE state codes, and "timelines" of each state creation. Provided as a Simple Data Format Data Package.
All standard state-codes are at
br-state-codes.csv (described by
datapackage.json), as "one stop" reliable sourse, and as curated reference to the digital preservation of datasets from Wikidata (semantic at
data/dump_wikidata) and OpenStreetMap (spatial at
data/dump_osm), as JSON dataset dumps.
The time-zone conventions are expressed in state-scale, so they are part of this dataset.
The official Brazilian regions are the state spatial containers, and at OSM represents "administrative boundaries level 3" (tag
admin_level=3), while states are level 4.
Dumps and database
At dump_wikidata dump of Wikidata item of each state (e.g.
MG.json) is preserved.
At dump_osm dump of Openstreetmap GeoJSON map of each state (e.g.
MG.geojson) is preserved.
The database relationships for CSV files is illustrated in the UML class diagram below:
br-city-codes.csv is a complementar dataset represented in the full-database presented in the diagram.
When necessary, same structure as
br-city-synonyms.csv can be used for state and region sets of synonyms.
More details here. Example:
|UF||Wikidata link||dump OSM||dump Wikidata|
|AC||acre = Q40780||AC map||AC wd-dump|
|AL||alagoas = Q40885||AL map||AL wd-dump|
|GB||extinct guanabara = Q1155409||no map?||GB wd-dump|
So, there are 4 opportunities to collabore:
- (any one) at the friendly public spreadsheet
- (github users) here, with issues or pull requests
- (wiki experts) at Wikidata
- (OSM users) at OpenStreetMap
We check here the consistency of all the parts, and we preserve all backups as stable snapshots.
Download the spreadsheet as CSV, and update git with it. When editing datapackage, test
goodtables datapackage.json and
git diff before commit.
Sources and references
LexML.gov.br as legislative reference for official documents (mainlly denominations and dates), and the main user of this repository.
Secondary and checking: