Division

Divisions are recognized official or non-official organizations of people as seen from a given political perspective.

Examples include countries, provinces, cities, towns, neighborhoods, etc.

Fields

Name	Type	Description
cartography(4)	CartographicHints (optional)	Cartographic hints useful when including the feature in maps
names(11)	Names	All known names by which the division is called
id	Id	A feature ID. This may be an ID associated with the Global Entity Reference System (GERS) if—and-only-if the feature represents an entity that is part of GERS.
bbox	bbox (optional)	An optional bounding box for the feature
geometry	geometry	Approximate location of a position commonly associated with the real-world entity modeled by the division feature. Allowed geometry types: Point
theme	"divisions"
type	"division"
version	FeatureVersion
sources[](10)	Sources (list, optional)	Information about the source data used to assemble the feature.
subtype	DivisionSubtype	A broad classification of the division (e.g., country, region, locality, etc.). admin_level is required when subtype is one of: county, macrocounty, region, macroregion, dependency, country parent_division_id is required when subtype ≠ country parent_division_id is forbidden when subtype = country
country	CountryCodeAlpha2	ISO 3166-1 alpha-2 country code of the country or country-like entity, that this division represents or belongs to. If the entity this division represents has a country code, the country property contains it. If it does not, the country property contains the country code of the first division encountered by traversing the parent_division_id chain to the root. For example: - The country value for the United States is 'US' - The country value for New York City is 'US' - The country value for Puerto Rico, a dependency of the US, is 'PR'. - The country value for San Juan, Puerto Rico is 'PR'. If an entity has an internationally-recognized ISO 3166-1 alpha-2 country code, it should always be used. In cases where the schema requires the code but no internationally-recognized code is available, a synthetic code may be used provided it does not conflict with any internationally-recognized codes.
hierarchies[][](3)	list<Hierarchy>	Hierarchies in which this division participates. Every division participates in at least one hierarchy. Most participate in only one. Some divisions may participate in more than one hierarchy, for example if they are claimed by different parent divisions from different political perspectives; or if there are other real-world reasons why the division or one of its ancestors has multiple parents. The first hierarchy in the list is the default hierarchy, and the second-to-last entry in the default hierarchy (if there is such an entry) always corresponds to the parent_division_id property. The ordering of hierarchies after the first one is arbitrary. Minimum length: 1 All items must be unique. (UniqueItemsConstraint)
parent_division_id	Id (optional)	Division ID of this division's parent division. Not allowed for top-level divisions (countries) and required for all other divisions. The default parent division is the parent division as seen from the default political perspective, if there is one, and is otherwise chosen somewhat arbitrarily. The hierarchies property can be used to inspect the exhaustive list of parent divisions. References Division (hierarchy, child of) parent_division_id is required when subtype ≠ country parent_division_id is forbidden when subtype = country
admin_level	AdminLevel (optional)	Integer representing the division's position in its country's administrative hierarchy, where lower numbers correspond to higher level administrative units. admin_level is required when subtype is one of: county, macrocounty, region, macroregion, dependency, country
class	DivisionClass (optional)	A more specific classification of the division than is provided by subtype.
local_type	CommonNames (map, optional)	Local name for the subtype property, optionally localized. For example, the Canadian province of Quebec has the subtype "region", but in the local administrative hierarchy it is referred to as a province. Similarly, the Canadian Yukon territory also has subtype "region", but is locally called a territory. This property is localized using a standard Overture names structure. So for example, in Switzerland the top-level administrative subdivision corresponding to subtype 'region' is the canton, which may be translated in each of Switzerland's official languages as, 'canton' in French, 'kanton' in German, 'cantone' in Italian, and 'chantun' in Romansh.
region	RegionCode (optional)	ISO 3166-2 principal subdivision code of the subdivision-like entity this division represents or belongs to. If the entity this division represents has a principal subdivision code, the region property contains it. If it does not, the region property contains the principal subdivision code of the first division encountered by traversing the parent_division_id chain to the root. For example: - The region value for the United States is omitted. - The region value for the U.S. state of New York is 'US-NY'. - The region value for New York City is 'US-NY', which it inherits from the state of New York. - The region value for Puerto Rico is 'US-PR'.
perspectives(2)	Perspectives (optional)	Political perspectives from which this division is considered to be an accurate representation. If this property is absent, then this division is not known to be disputed from any political perspective. Consequently, there is only one division feature representing the entire real world entity. If this property is present, it means the division represents one of several alternative perspectives on the same real-world entity. There are two modes of perspective: 1. accepted_by means the representation of the division is accepted by the listed entities and would be included on a map drawn from their perspective. 2. disputed_by means the representation of the division is disputed by the listed entities and would be excluded from a map drawn from their perspective. When drawing a map from the perspective of a given country, one would start by gathering all the undisputed divisions (with no perspectives property), and then adding to that first all divisions explicitly accepted by the country, and second all divisions not explicitly disputed by the country.
norms(1)	Norms (optional)	Collects information about local norms and rules within the division that are generally useful for mapping and map-related use cases. If the norms property or a desired sub-property of the norms property is missing on a division, but at least one of its ancestor divisions has the norms property and the desired sub-property, then the value from the nearest ancestor division may be assumed.
population	int32 (optional)	Population of the division ≥ 0
capital_division_ids	list<Id> (optional)	Division IDs of this division's capital divisions. If present, this property will refer to the division IDs of the capital cities, county seats, etc. of a division. Minimum length: 1 All items must be unique. (UniqueItemsConstraint) References Division (hierarchy, has as capital)
capital_of_divisions[](2)	list<CapitalOfDivisionItem> (optional)	Division IDs and subtypes of divisions this division is a capital of. Minimum length: 1 All items must be unique. (UniqueItemsConstraint)
wikidata	WikidataId (optional)	A wikidata ID, as found on https://www.wikidata.org/

Constraints

• admin_level is required when subtype is one of: county, macrocounty, region, macroregion, dependency, country
• parent_division_id is required when subtype ≠ country
• parent_division_id is forbidden when subtype = country

Examples

Column	Value
cartography	null
names.primary	Kauaʻi County
names.common	{"haw": "kalana Kaua\u02bbi"}
id	c9b8adc9-4639-4392-8efe-8401eeb19929
bbox.xmin	-159.49453735351562
bbox.ymin	22.05571746826172
bbox.xmax	-159.4945068359375
bbox.ymax	22.055721282958984
geometry	POINT (-159.4945109 22.0557204)
theme	divisions
type	division
version	5
sources[0].property
sources[0].dataset	OpenStreetMap
sources[0].license	ODbL-1.0
sources[0].record_id	r166560@15
sources[0].update_time	2025-08-16T14:25:55+00:00
sources[0].confidence	null
sources[0].provider	null
sources[0].resource	null
sources[0].version	null
sources[0].between	null
subtype	county
country	US
hierarchies[0][0].division_id	f39eb4af-5206-481b-b19e-bd784ded3f05
hierarchies[0][0].subtype	country
hierarchies[0][0].name	United States
hierarchies[0][1].division_id	a2a08395-e968-4be5-bdd7-7f63db8c2165
hierarchies[0][1].subtype	region
hierarchies[0][1].name	Hawaii
hierarchies[0][2].division_id	c9b8adc9-4639-4392-8efe-8401eeb19929
hierarchies[0][2].subtype	county
hierarchies[0][2].name	Kauaʻi County
parent_division_id	a2a08395-e968-4be5-bdd7-7f63db8c2165
admin_level	2
class	null
local_type	{"en": "county"}
region	US-HI
perspectives	null
norms	null
population	71735
capital_division_ids	["958c67d3-868a-482d-9dd8-1c65b0c1a9e8"]
capital_of_divisions	null
wikidata	Q111517
names.rules[0].value	Kauai County
names.rules[0].variant	alternate
names.rules[0].language	null
names.rules[0].perspectives	null
names.rules[0].between	null
names.rules[0].side	null