Demo version. Please do not buy: purchases are test only and will not be processed.

Language: EN

Brazil administrative boundaries

5 regions, 27 states and 5,571 municipalities, each with its official code, in GeoJSON, TopoJSON, GeoPackage, Shapefile, layered SVG, CSV and SQL.

Get the free sample
regions
5
states
27
municipalities
5,571
edition
Outline of Brazil

One of the examples in the package

A layered SVG coloured from a table with a few lines of plain JavaScript: every entity is a path whose id is its official code. The page shows a part of the country: the two levels share the same borders, so they fit without gaps. The package has every entity of every level.

São Paulo: its municipalities, coloured by area, among the neighbouring states.

What is in the package

Levels and identifiers

LevelEntitiesIdentifier
country1BR
regions5BR-R-<official code>
states27BR-P-<official code>
municipalities5,571BR-M-<official code>

Every entity has the same identifier in every file: it is the feature id in GeoJSON and TopoJSON, the id of the path in SVG and the id column of the tables.

Formats and scales

Format full 100m 1km 10km light
GeoJSON 452.6 MB 55.3 MB 8.0 MB 88 KB 875 KB
TopoJSON 79.1 MB 13.0 MB 3.2 MB 27 KB 562 KB
Shapefile 338.0 MB 41.3 MB 5.9 MB 67 KB 662 KB
SVG - 53.5 MB 7.6 MB 83 KB 864 KB
  • full: the boundaries as published by the source.
  • 100m: simplified within 100 m and coherent: municipalities, states and regions share exactly the same border vertices.
  • 1km: simplified within 1 km and coherent like 100m, every level: the whole country on a web map.
  • 10km: simplified within 10 km and coherent, country, regions and states only: small maps and maps of many countries.
  • light: country, regions and states only, each level simplified on its own to a small file.
  • GeoJSON: one FeatureCollection per level, WGS84. TopoJSON: all the levels in one topology, shared borders are shared arcs.
  • GeoPackage: data/geopackage/br.gpkg (399.6 MB), one file for QGIS and ArcGIS with every level at every scale as a layer (municipalities_100m) with its spatial index, and every table of the package.
  • Shapefile: one per level and scale, WGS84, UTF-8; the columns longer than ten characters are shortened (region, province, abbrev).
  • SVG: one file per level and one with every level as a layer, in a Lambert conformal conic projection; they open as layers in Illustrator, Figma and Inkscape.
  • SQL: a script for PostGIS, one for MySQL 8 and one for SQL Server (55.4 MB each). It creates one table with every entity of every level, its 100m boundary in WGS84 and its indexes.
  • JSON: data/json/tree.json (473 KB), the levels nested and sorted by name, without boundaries: what the select boxes of a form need.

Tables

CSV, UTF-8. Names in EN, IT, ES, FR, DE, NL, PT, besides the official one.

FileRowsContent
tables/country.csv 1 The country: names, population, bounding box, centre and label point.
code, name, population, min_lat, min_lng, max_lat, max_lng, center_lat, center_lng, label_lat, label_lng, id, name_en, name_it, name_es, name_fr, name_de, name_nl, name_pt
tables/regions.csv 5 The regions: official code, names, area, population, bounding box, centre and label point.
code, name, area_km2, population, min_lat, min_lng, max_lat, max_lng, center_lat, center_lng, label_lat, label_lng, id, name_en, name_it, name_es, name_fr, name_de, name_nl, name_pt
tables/provinces.csv 27 The states: official code, abbreviation, the code of the parent, names, area, population, bounding box, centre and label point.
code, name, abbreviation, region_code, area_km2, population, min_lat, min_lng, max_lat, max_lng, center_lat, center_lng, label_lat, label_lng, id, name_en, name_it, name_es, name_fr, name_de, name_nl, name_pt
tables/municipalities.csv 5,571 The municipalities: official code, the codes of the parents, names, area, population, elevation in metres (of the centre, or lowest and highest point, as the official source gives it), bounding box, centre and label point.
code, name, province_code, province_abbreviation, region_code, cadastral_code, chief_town, area_km2, population, elevation, elevation_min, elevation_max, elevation_mean, min_lat, min_lng, max_lat, max_lng, center_lat, center_lng, label_lat, label_lng, id, name_en, name_it, name_es, name_fr, name_de, name_nl, name_pt
tables/codes.csv 5,604 Every entity in other datasets, as Wikidata declares it: the Wikidata item, ISO 3166-2, GeoNames and the OpenStreetMap relation.
id, level, code, wikidata, iso_3166_2, geonames, osm_relation
tables/names.csv 5,853 Every name an entity is written with (official, each side of a bilingual name, translated), without accents and as a slug: to match a file that has names and no codes.
id, level, name, name_ascii, slug, kind
tables/neighbours.csv 33,104 The entities of the same level that share a border, both ways, with the length of the shared border in km.
level, id, neighbour_id, shared_border_km
tables/history.csv 0 The suppressed municipalities with the one that replaced them, for archives that still have the old codes; no rows where the official source gives no history.
code, name, province_code, replaced_by_code, replaced_by_name
tables/changes.csv 0 What changed from one edition of the package to the next, one row per entity added, removed, renamed, moved or with a new boundary: the same as CHANGELOG.md.
edition, date, level, id, name, change, before, after

Files

All the 149 files of the package, with their size.

ATTRIBUTION.md2 KB
CHANGELOG.md0 KB
LICENSE.md2 KB
README.md12 KB
data/geojson/100m/country.geojson1.3 MB
data/geojson/100m/municipalities.geojson47.7 MB
data/geojson/100m/provinces.geojson4.0 MB
data/geojson/100m/regions.geojson2.3 MB
data/geojson/10km/country.geojson12 KB
data/geojson/10km/provinces.geojson51 KB
data/geojson/10km/regions.geojson24 KB
data/geojson/1km/country.geojson159 KB
data/geojson/1km/municipalities.geojson7.0 MB
data/geojson/1km/provinces.geojson557 KB
data/geojson/1km/regions.geojson295 KB
data/geojson/full/municipalities.geojson409.8 MB
data/geojson/full/provinces.geojson25.2 MB
data/geojson/full/regions.geojson17.6 MB
data/geojson/light/country.geojson41 KB
data/geojson/light/provinces.geojson626 KB
data/geojson/light/regions.geojson208 KB
data/geopackage/br.gpkg399.6 MB
data/json/tree.json473 KB
data/shapefile/100m/country.cpg0 KB
data/shapefile/100m/country.dbf0 KB
data/shapefile/100m/country.prj0 KB
data/shapefile/100m/country.shp1.0 MB
data/shapefile/100m/country.shx0 KB
data/shapefile/100m/municipalities.cpg0 KB
data/shapefile/100m/municipalities.dbf566 KB
data/shapefile/100m/municipalities.prj0 KB
data/shapefile/100m/municipalities.shp34.9 MB
data/shapefile/100m/municipalities.shx44 KB
data/shapefile/100m/provinces.cpg0 KB
data/shapefile/100m/provinces.dbf2 KB
data/shapefile/100m/provinces.prj0 KB
data/shapefile/100m/provinces.shp3.0 MB
data/shapefile/100m/provinces.shx0 KB
data/shapefile/100m/regions.cpg0 KB
data/shapefile/100m/regions.dbf0 KB
data/shapefile/100m/regions.prj0 KB
data/shapefile/100m/regions.shp1.7 MB
data/shapefile/100m/regions.shx0 KB
data/shapefile/10km/country.cpg0 KB
data/shapefile/10km/country.dbf0 KB
data/shapefile/10km/country.prj0 KB
data/shapefile/10km/country.shp10 KB
data/shapefile/10km/country.shx0 KB
data/shapefile/10km/provinces.cpg0 KB
data/shapefile/10km/provinces.dbf2 KB
data/shapefile/10km/provinces.prj0 KB
data/shapefile/10km/provinces.shp36 KB
data/shapefile/10km/provinces.shx0 KB
data/shapefile/10km/regions.cpg0 KB
data/shapefile/10km/regions.dbf0 KB
data/shapefile/10km/regions.prj0 KB
data/shapefile/10km/regions.shp18 KB
data/shapefile/10km/regions.shx0 KB
data/shapefile/1km/country.cpg0 KB
data/shapefile/1km/country.dbf0 KB
data/shapefile/1km/country.prj0 KB
data/shapefile/1km/country.shp122 KB
data/shapefile/1km/country.shx0 KB
data/shapefile/1km/municipalities.cpg0 KB
data/shapefile/1km/municipalities.dbf566 KB
data/shapefile/1km/municipalities.prj0 KB
data/shapefile/1km/municipalities.shp4.6 MB
data/shapefile/1km/municipalities.shx44 KB
data/shapefile/1km/provinces.cpg0 KB
data/shapefile/1km/provinces.dbf2 KB
data/shapefile/1km/provinces.prj0 KB
data/shapefile/1km/provinces.shp418 KB
data/shapefile/1km/provinces.shx0 KB
data/shapefile/1km/regions.cpg0 KB
data/shapefile/1km/regions.dbf0 KB
data/shapefile/1km/regions.prj0 KB
data/shapefile/1km/regions.shp222 KB
data/shapefile/1km/regions.shx0 KB
data/shapefile/full/municipalities.cpg0 KB
data/shapefile/full/municipalities.dbf566 KB
data/shapefile/full/municipalities.prj0 KB
data/shapefile/full/municipalities.shp305.4 MB
data/shapefile/full/municipalities.shx44 KB
data/shapefile/full/provinces.cpg0 KB
data/shapefile/full/provinces.dbf2 KB
data/shapefile/full/provinces.prj0 KB
data/shapefile/full/provinces.shp18.8 MB
data/shapefile/full/provinces.shx0 KB
data/shapefile/full/regions.cpg0 KB
data/shapefile/full/regions.dbf0 KB
data/shapefile/full/regions.prj0 KB
data/shapefile/full/regions.shp13.2 MB
data/shapefile/full/regions.shx0 KB
data/shapefile/light/country.cpg0 KB
data/shapefile/light/country.dbf0 KB
data/shapefile/light/country.prj0 KB
data/shapefile/light/country.shp31 KB
data/shapefile/light/country.shx0 KB
data/shapefile/light/provinces.cpg0 KB
data/shapefile/light/provinces.dbf2 KB
data/shapefile/light/provinces.prj0 KB
data/shapefile/light/provinces.shp470 KB
data/shapefile/light/provinces.shx0 KB
data/shapefile/light/regions.cpg0 KB
data/shapefile/light/regions.dbf0 KB
data/shapefile/light/regions.prj0 KB
data/shapefile/light/regions.shp157 KB
data/shapefile/light/regions.shx0 KB
data/topojson/100m/br.topojson13.0 MB
data/topojson/10km/br.topojson27 KB
data/topojson/1km/br.topojson3.2 MB
data/topojson/full/br.topojson79.1 MB
data/topojson/light/br.topojson562 KB
examples/choropleth-svg.html2.0 MB
examples/drill-down-d3.html1.3 MB
examples/leaflet-geojson.html629 KB
examples/lib/LICENSES.md3 KB
examples/lib/d3.min.js273 KB
examples/lib/leaflet.css14 KB
examples/lib/leaflet.js144 KB
examples/lib/topojson-client.min.js7 KB
examples/point-lookup.html4.0 MB
flags/BR.svg7 KB
sql/mysql.sql55.6 MB
sql/postgis.sql55.4 MB
sql/sqlserver.sql55.6 MB
svg/100m/layers.svg27.1 MB
svg/100m/municipalities.svg23.3 MB
svg/100m/provinces.svg2.0 MB
svg/100m/regions.svg1.1 MB
svg/10km/layers.svg44 KB
svg/10km/provinces.svg26 KB
svg/10km/regions.svg13 KB
svg/1km/layers.svg3.9 MB
svg/1km/municipalities.svg3.4 MB
svg/1km/provinces.svg282 KB
svg/1km/regions.svg149 KB
svg/light/layers.svg442 KB
svg/light/provinces.svg317 KB
svg/light/regions.svg105 KB
tables/changes.csv0 KB
tables/codes.csv332 KB
tables/country.csv0 KB
tables/history.csv0 KB
tables/municipalities.csv1.2 MB
tables/names.csv431 KB
tables/neighbours.csv1.5 MB
tables/provinces.csv5 KB
tables/regions.csv1 KB

The package of Brazil is not on sale yet. You can try it now: get the free sample, Central-West (4 states and 468 municipalities) with the same files and formats.