geoBoundaries CGAZ Global Administrative Boundaries ADM0, ADM1, ADM2 (GeoParquet, PMTiles, name index)

Provider
geoBoundaries (William & Mary geoLab); Portolan mirror
License
CC-BY-4.0 (source)
Format
JSON (in sampled files)
Stored at
Amazon S3, s3://us-west-2.opendata.source.coop/portolan-mirrors/geoboundaries-catalog (us-west-2)
Access
Free and public. No account with the data provider is needed.
Category
Earth Observation & Geospatial
Source
https://doi.org/10.1371/journal.pone.0231866

About this dataset

Every boundary in the geoBoundaries Comprehensive Global Administrative Zones (CGAZ) composite, produced by William & Mary geoLab and the geoBoundaries community, as cloud-native GeoParquet 1.1 and PMTiles. Four collections: adm0 (218 country outlines plus 20 disputed areas), adm1 (3,224 states, provinces, regions and governorates), adm2 (49,349 counties, districts, municipalities and communes) and names (52,398 named units, a sorted search index for autocomplete with shapeID joins). The levels cover the globe seamlessly; where a country has no ADM1 or ADM2 data the coarser polygon is carried up and shapeType says which level is present. Each level also has a simplified display file buffered outward so it contains the true boundary. The mirror repairs 38 double-encoded names, 1,275 invalid geometries and a missing CRS, documented in changes-from-upstream.md; per-country gbOpen releases are not included. Files are Hilbert-sorted with small row groups for range requests. Read with DuckDB, geopandas or GDAL. Licensed CC BY 4.0 by geoBoundaries; cite Runfola et al. (2020), PLoS ONE 15(4):e0231866.

How to access this dataset in Python

import boto3
from botocore import UNSIGNED
from botocore.client import Config
s3 = boto3.client('s3', region_name='us-west-2', config=Config(signature_version=UNSIGNED))
s3.list_objects_v2(Bucket='us-west-2.opendata.source.coop', Prefix='portolan-mirrors/geoboundaries-catalog/', Delimiter='/')

Lists the files with anonymous access. Runs on any machine, with no cloud account.

Data structure

File types in sampled files: JSON

Files

Example file: portolan-mirrors/geoboundaries-catalog/adm0/styles/adm1-units.json

Analyze this dataset without downloading it

On Scigantic, geoBoundaries CGAZ Global Administrative Boundaries ADM0, ADM1, ADM2 (GeoParquet, PMTiles, name index) opens in a hosted JupyterLab notebook with the data already mounted, so you can read files where they are stored instead of copying them first. Each notebook includes an AI assistant that can see the mounted files and write and run analysis code. Open the dataset page to launch a notebook, or browse the full catalog.

This page is also available as Markdown and as JSON.

Related Earth Observation & Geospatial datasets