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

## Facts

- Provider: geoBoundaries (William & Mary geoLab); Portolan mirror
- License: CC-BY-4.0 (https://www.geoboundaries.org/)
- Format: JSON (in sampled files)
- Stored at: Amazon S3, s3://us-west-2.opendata.source.coop/portolan-mirrors/geoboundaries-catalog (us-west-2)
- Access: public, readable without an account
- Category: Earth Observation & Geospatial
- Source: https://doi.org/10.1371/journal.pone.0231866
- Page: https://scigantic.com/archive/5b82f6af-9a54-561d-a948-db3f1b0c1823
- Keywords: Earth Observation & Geospatial, JSON, AWS Open Data

## About

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.

## Load the data

```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

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

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/5b82f6af-9a54-561d-a948-db3f1b0c1823
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/5b82f6af-9a54-561d-a948-db3f1b0c1823
- Over MCP: `get_schema_card` with id `5b82f6af-9a54-561d-a948-db3f1b0c1823` at https://api.scigantic.com/mcp

## Related topics

- [Earth Observation & Geospatial datasets](https://scigantic.com/topics/earth-observation-and-geospatial)
- [JSON datasets](https://scigantic.com/topics/json)
