Geodata data package providing geojson polygons for the largest administrative subdivisions in every countries.

Data

The data comes from geoboundaries, a community effort to make visually pleasing, well-crafted maps with cartography or GIS software at small scale.

Admin1 is the biggest administrative subdivision of countries. Note that it is very heterogeneous among countries : in the United States of America, admin1 represents states, whereas they don't represent the inner countries in the United Kingdom. For more information, please see official documentation or https://en.wikipedia.org/wiki/Table_of_administrative_divisions_by_country.

The shape of the admin1 data has the following fields:

geometry:
Represents the spatial geometry of the administrative subdivision. It includes:
- The type of geometry (e.g., Polygon, MultiPolygon).
- The associated coordinates that define its boundaries.
properties:
Contains metadata describing the administrative subdivision, with the following fields:
- name:
  The common name for this admin1 subdivision.
- id:
  Code for the subdivision inside the country. Documentation is not clear what this code is, but it could be FIPS. Note that some countries, like Vatican, are so small they don't have inner administrative subdivisions. In such cases, the code could be null and is irrelevant.
- country:
  The name of the country where the subdivision is located.
- ISO3166-1-Alpha-3:
  The three-letter ISO code of the country.
type:
Specifies the type of the feature, typically Feature for each administrative subdivision.

Preparation

To run the script:

# Install libraries
pip install -r scripts/requirements.txt

# Update the data
python scripts/process.py

Note that the original data from geoboundaries is public domain. While no credit is formally required a link back or credit to geoboundaries, Lexman and the Open Knowledge Foundation is much appreciated.

All source code is licenced under the MIT licence.