admin1
| Field | Type | Description |
|---|---|---|
| name | string | Common name of the administrative subdivision |
| admin | string | Country name |
| iso_3166_2 | string | ISO 3166-2 subdivision code |
| adm0_a3 | string | ISO 3166-1 alpha-3 country code |
Polygons polygons for the largest administrative subdivisions in every countries
Report an issue| Field | Type | Description |
|---|---|---|
| name | string | Common name of the administrative subdivision |
| admin | string | Country name |
| iso_3166_2 | string | ISO 3166-2 subdivision code |
| adm0_a3 | string | ISO 3166-1 alpha-3 country code |
Part of a data solution
GeoJSON polygons for the first-order administrative subdivisions of the world (states, provinces, regions and similar), taken from Natural Earth.
Column definitions and types are in datapackage.json.
data/admin1.geojson is one GeoJSON FeatureCollection. Each feature is one subdivision, as a Polygon or MultiPolygon. The properties of each feature are the Natural Earth attributes, unchanged. The main ones are:
| Property | Meaning |
|---|---|
name | Common name of the subdivision, for example Entre Ríos |
admin | Name of the country it belongs to, for example Argentina |
iso_3166_2 | ISO 3166-2 code of the subdivision, for example AR-E |
adm0_a3 | Country code, for example ARG. This is a Natural Earth code. It follows ISO 3166-1 alpha-3, but disputed and special areas have codes of their own, for example CYN for Northern Cyprus |
iso_a2 | 2-letter country code, for example AR. -1 for disputed and special areas |
type, type_en | Kind of subdivision in the local language and in English, for example Provincia and Province |
name_alt, name_local | Alternative name and local-language name, where known |
name_en, name_fr, name_ja … | Name translations (from Wikidata). One name_<language code> column per language |
code_hasc, fips, postal | Codes from other systems (HASC, FIPS, postal abbreviation), for example AR.ER, AR08, ER |
wikidataid | Wikidata identifier, for example Q44762 |
gn_id, gn_name, gns_id, gns_name, woe_id, woe_label, woe_name | Identifiers and names from GeoNames, the US NGA GNS and WOE (Yahoo/Flickr "Where on Earth") |
latitude, longitude | A single point for the subdivision, not the polygon |
FCLASS_ISO, FCLASS_US … | Natural Earth feature-class labels, one column per country or standard. See the Natural Earth documentation |
The other properties are Natural Earth map-drawing hints (for example scalerank, labelrank, min_label, max_label, mapcolor9). datapackage.json lists only the four main fields (name, admin, iso_3166_2, adm0_a3). Every property is in the file.
Admin-1 is the first level below the country. It is very different from country to country: in the United States of America it is the states, whereas in the United Kingdom it does not represent the inner countries (England, Scotland and so on). For more information, see the Natural Earth documentation or the table of administrative divisions by country.
name is empty (null) for some features. Do not use it as a key.iso_3166_2 is always filled, but some values are Natural Earth placeholders rather than real ISO codes. They are used for disputed or special areas, for example SY-X01~ or -99-X16~. Real ISO codes look like AR-E.iso_3166_2 is not unique. Some codes appear on more than one feature, for example a city and the province around it, or several districts that carry the code of their region. Join on it with care.adm0_a3 is not always an ISO code (see the table), and iso_a2 is -1 for some disputed and special areas.name_local, region, note).name_*) and wikidataid. Licence: CC0, as stated by Natural Earth.type_en, which Natural Earth's licensing note ties to GADM). Licence: unclear (see License).Changes made to the source data: the file is downloaded from the Natural Earth repository and republished with one change: the top-level crs member is removed. All features and properties are otherwise unchanged.
Not endorsed by, or affiliated with, Natural Earth.
The script needs Python 3 and the requests library. To rebuild data/admin1.geojson:
# Install libraries
pip install -r scripts/requirements.txt
# Update the data
python scripts/process.py
The script downloads ne_10m_admin_1_states_provinces.geojson from the master branch of the Natural Earth vector repository on GitHub. That branch is a development version, not a numbered release, so it can be ahead of the published releases.
A GitHub Actions workflow runs the script on the 1st of every month (and on pushes to main and on manual runs), and commits data/admin1.geojson if it changed.
Natural Earth's terms of use put its data in the public domain. They say: "No permission is needed to use Natural Earth. Crediting the authors is unnecessary." Commercial use is allowed. The name translations (name_*) come from Wikidata, which Natural Earth says is CC0.
Unclear: some columns. We could not establish the licence of the columns below. The data is published as is. Nothing has been removed.
type_en. Natural Earth's own licensing note (a forum post from December 2009) says some admin-1 columns depend on GADM. It tells users who are worried about licensing to delete them. GADM's terms say: "Redistribution or commercial use is not allowed without prior permission." The post names three columns: the English type, "valid from" and "valid to". This file still has type_en. It does not have valid_from or valid_to. We found no later statement from Natural Earth or GADM that settles this.gn_name, woe_label and woe_name. These are text names taken from other databases (GeoNames and Yahoo/Flickr WOE). Natural Earth says the non-geometry attributes are "commonly available facts that are not copyrightable". Nobody has independently confirmed that for these columns. GeoNames publishes its database under CC BY 4.0.woe_*, gns_* and code_hasc columns). We make no claim about them.The maintainers offer this package under the Open Data Commons Public Domain Dedication and License (PDDL) 1.0. In plain words, that covers only what the maintainers add, and the parts that Natural Earth places in the public domain. It does not settle the unclear columns above.
All source code is licensed under the MIT licence.
See ATTRIBUTION.txt for the source credit and the change made to the source data.
API access
Each file has a stable URL (r-link) that you can use directly in scripts, apps, or AI agents. These URLs are permanent and safe to hardcode.