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
- DOE Open Energy Data Initiative: Data Catalog of the Open Energy Data Initiative (OEDI)
- HIRLAM Weather Model
- Agricultural Field Boundaries over EU
- Central Asia Crop Type Polygons (Uzbekistan and Tajikistan, Aral Sea Basin)
- Multi-Resolution Land Characteristics (MRCL)
- MODIS/Terra Surface Reflectance Daily L2G Global 1km and 500m SIN Grid V061
- NREL WIND Toolkit: Techno-economic subset of the WIND Toolkit by location in netCDF format
- National Building Height Dataset