Division area
A division area is a polygon that represents the land or maritime area associated with a division.
Geometry Type | Polygon or MultiPolygon |
---|---|
Theme | divisions |
Type | division_area |
Subtypes
While the schema for the divisions theme contains an comprehensive list of subtypes, only a subset are available in the data today.
Currently, the following subtypes are available in the division_area
feature type:
country
dependency
region
county
localadmin
locality
macrohood
neighborhood
- country
- dependency
- region
- county
- localadmin
- locality
- macrohood
- neighborhood
subtype | country |
---|
A country is the largest unit of independent sovereignty. The border of a country, if known, is given by divsion boundary features. Example: United States
subtype | dependency |
---|
A dependency is a place that is not exactly a sub-region of a country but is dependent on a parent country for defense, passport control, etc. Example: Puerto Rico
subtype | region |
---|
A region is the largest administrative unit within most countries and a first-level administrative subdivision. Example: Alberta
subtype | county |
---|
A county is a second-level administrative subdivision. Example: Kings County, NY
subtype | localadmin |
---|
Localadmin is a level of government in some parts of the world that contains localities or populated places that themselves have no authority. Often but not exclusively found in Europe. Localadmin is a third-level administrative subdivision. Example: Paris
subtype | locality |
---|
A locality is a populated place that may or may not have its own administrative authority. (It won't if it belongs to a localadmin.) Locality may be a third-level administrative subdivision. Example: Taipei
subtype | macrohood |
---|
A macrohood is a super-neighborhood that contains smaller divisions of type neighborhood. Example: BoCoCa (Boerum Hill, Cobble Hill, and Carroll Gardens)
subtype | neighborhood |
---|
A neighborhood is a geographically localized community within a city, town, suburb or rural area, sometimes consisting of a single street and the buildings lining it. Example: Cobble Hill
Schema
- Browsable
- YAML
---
"$schema": https://json-schema.org/draft/2020-12/schema
title: division_area
description:
Division areas are polygons that represent the land or maritime area
covered by a division.
Each division area belongs to a division which it references by ID,
and for which the division area provides an area polygon. For ease of
use, every division area repeats the subtype, names, country, and
region properties of the division it belongs to.
type: object
properties: # JSON Schema: Top-level object properties.
id: { "$ref": ../defs.yaml#/$defs/propertyDefinitions/id }
geometry:
description:
Division area geometries MUST be polygons or multi-polygons as
defined by the GeoJSON schema.
unevaluatedProperties: false
oneOf:
- "$ref": https://geojson.org/schema/Polygon.json
- "$ref": https://geojson.org/schema/MultiPolygon.json
properties: # GeoJSON: top-level object 'properties' property.
unevaluatedProperties: false
required: [names, subtype, class, country, division_id]
allOf:
- "$ref": ../defs.yaml#/$defs/propertyContainers/overtureFeaturePropertiesContainer
- "$ref": ../defs.yaml#/$defs/propertyContainers/namesContainer
properties: # JSON Schema: properties within GeoJSON top-level object 'properties' property
subtype: { "$ref": "./defs.yaml#/$defs/propertyDefinitions/placetype" }
class:
type: string
enum:
- land # The area does not extend beyond the coastline.
- maritime # The area extends beyond the coastline, in most
# cases to the extent of the division's
# territorial sea, if it has one.
division_id:
description:
Division ID of the division this area belongs to.
allOf:
- "$ref": ../defs.yaml#/$defs/propertyDefinitions/id
country:
description:
ISO 3166-1 alpha-2 country code of the division this area
belongs to.
allOf:
- "$ref": "../defs.yaml#/$defs/propertyDefinitions/iso3166_1Alpha2CountryCode"
region:
description:
ISO 3166-2 principal subdivision code of the division this area
belongs to.
allOf:
- "$ref": "../defs.yaml#/$defs/propertyDefinitions/iso3166_2SubdivisionCode"
Examples
- country, land class
- country, maritime class
- region, land class
{
"id": "example:division_area:land:country:us",
"type": "Feature",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
-170.6290015,
25.3053671
],
[
-170.4076134,
25.5082632
],
[
-170.6300336,
25.7076006
],
[
-170.8506754,
25.5056948
],
[
-170.6290015,
25.3053671
]
]
],
[
[
[
-171.7380245,
25.555318
],
[
-171.4949943,
25.7747795
],
[
-171.726725,
25.9865667
],
[
-171.9674222,
25.7845748
],
[
-171.7380245,
25.555318
]
]
],
[
[
[
-174.0155727,
25.8411597
],
[
-173.7437151,
26.0119599
],
[
-173.905507,
26.2639004
],
[
-174.2280618,
26.0816774
],
[
-174.0155727,
25.8411597
]
]
],
[
[
[
-175.9506918,
27.5543172
],
[
-175.5545765,
27.7281369
],
[
-175.6295776,
28.1237431
],
[
-176.1866168,
27.9330153
],
[
-175.9506918,
27.5543172
]
]
],
[
[
[
-166.1182936,
23.4254685
],
[
-165.8702478,
23.8636297
],
[
-166.3767961,
24.0561939
],
[
-166.5303209,
23.7815879
],
[
-166.1182936,
23.4254685
]
]
],
[
[
[
-167.9975573,
24.7968943
],
[
-167.778217,
25.0023686
],
[
-168.005803,
25.20088
],
[
-168.2206497,
24.9967937
],
[
-167.9975573,
24.7968943
]
]
],
[
[
[
-157.4082814,
55.576068
],
[
-157.1024297,
55.6733491
],
[
-157.0908436,
55.8696588
],
[
-157.7232999,
55.870247
],
[
-157.4082814,
55.576068
]
]
],
[
[
[
-155.6071465,
55.55087
],
[
-155.2980807,
56.0385909
],
[
-156.1270413,
55.9006965
],
[
-156.0182299,
55.6525826
],
[
-155.6071465,
55.55087
]
]
],
[
[
[
-178.3063127,
28.1837783
],
[
-178.0577766,
28.4309636
],
[
-178.3589518,
28.655272
],
[
-178.60056,
28.4012455
],
[
-178.3063127,
28.1837783
]
]
],
[
[
[
-179.1390989,
51.0070029
],
[
-173.0611771,
51.8159234
],
[
-171.9740685,
52.3514335
],
[
-178.9229631,
52.0275532
],
[
-179.1390989,
51.0070029
]
]
],
[
[
[
-180,
51.7940888
],
[
-179.8836979,
51.9764894
],
[
-180,
52.138489
],
[
-180,
51.8434509
],
[
-180,
51.7940888
]
]
],
[
[
[
-170.3952428,
56.8431693
],
[
-169.6956679,
57.0307607
],
[
-169.5801239,
57.2365744
],
[
-170.6525321,
57.3494254
],
[
-170.3952428,
56.8431693
]
]
],
[
[
[
-169.5771945,
56.3323838
],
[
-169.1322924,
56.6737641
],
[
-170.1288343,
56.6777795
],
[
-170.0250438,
56.4580184
],
[
-169.5771945,
56.3323838
]
]
],
[
[
[
-168.0561273,
64.76067
],
[
-167.5930406,
65.0286657
],
[
-168.5591053,
65.007885
],
[
-168.4482776,
64.8327172
],
[
-168.0561273,
64.76067
]
]
],
[
[
[
-156.6720152,
20.3000654
],
[
-155.800111,
20.8826396
],
[
-158.455088,
21.6943824
],
[
-158.2462379,
21.1430868
],
[
-156.6720152,
20.3000654
]
]
],
[
[
[
-160.5398128,
21.4482644
],
[
-159.3028431,
21.7124132
],
[
-159.1241278,
22.2798801
],
[
-160.2161715,
22.1993854
],
[
-160.5398128,
21.4482644
]
]
],
[
[
[
-161.9236658,
22.8550496
],
[
-161.6972866,
23.0665997
],
[
-161.9360903,
23.2652845
],
[
-162.1455351,
23.0568827
],
[
-161.9236658,
22.8550496
]
]
],
[
[
[
-164.7000199,
23.3734366
],
[
-164.4760626,
23.575844
],
[
-164.7056774,
23.7796906
],
[
-164.9238496,
23.5726775
],
[
-164.7000199,
23.3734366
]
]
],
[
[
[
-155.6810194,
18.7091718
],
[
-154.595509,
19.5434371
],
[
-155.877534,
20.4681176
],
[
-156.2732568,
19.7049213
],
[
-155.6810194,
18.7091718
]
]
],
[
[
[
-82.8732511,
24.4116731
],
[
-82.5948517,
24.5902399
],
[
-82.7300073,
24.8395704
],
[
-83.153058,
24.6776636
],
[
-82.8732511,
24.4116731
]
]
],
[
[
[
-81.8773353,
24.2520071
],
[
-68.1545602,
47.3251568
],
[
-82.6797222,
41.6765556
],
[
-84.129,
46.5305
],
[
-94.9573889,
49.3701944
],
[
-125.0271096,
48.4630615
],
[
-119.6795205,
33.0665347
],
[
-97.40561,
25.83764
],
[
-84.0549877,
29.8627705
],
[
-81.8773353,
24.2520071
]
]
],
[
[
[
179.2356588,
51.1468561
],
[
178.6498473,
52.169477
],
[
176.8813625,
51.9348227
],
[
177.1853792,
51.6303915
],
[
179.2356588,
51.1468561
]
]
],
[
[
[
179.6302237,
51.6862391
],
[
180,
52.1384488
],
[
179.2193828,
52.1042624
],
[
179.2227021,
51.833522
],
[
179.6302237,
51.6862391
]
]
],
[
[
[
175.915408,
52.1325238
],
[
176.2623207,
52.4572425
],
[
175.5671255,
52.4969017
],
[
175.5586568,
52.2829505
],
[
175.915408,
52.1325238
]
]
],
[
[
[
173.6474085,
52.1472948
],
[
174.8392132,
52.6878183
],
[
172.1158739,
52.9881155
],
[
173.132385,
52.2506975
],
[
173.6474085,
52.1472948
]
]
],
[
[
[
-146.3855284,
59.1843829
],
[
-145.9234279,
59.3169728
],
[
-145.8952803,
59.5345003
],
[
-146.6535985,
59.6545361
],
[
-146.3855284,
59.1843829
]
]
],
[
[
[
-171.2797217,
52.2444061
],
[
-145.9885379,
60.1761058
],
[
-130.003485,
56.008075
],
[
-141.00198,
60.3063692
],
[
-140.7523256,
69.8283004
],
[
-156.6515529,
71.581159
],
[
-169.0485821,
65.4690061
],
[
-161.2500247,
63.8004626
],
[
-167.6542464,
59.9434356
],
[
-158.0753114,
57.7475562
],
[
-171.2797217,
52.2444061
]
],
[
[
-153.8125943,
58.0958144
],
[
-153.5773523,
58.3547948
],
[
-153.3559904,
58.4231127
],
[
-153.6200524,
58.260124
],
[
-153.8125943,
58.0958144
]
],
[
[
-153.1820044,
58.5355625
],
[
-153.1751501,
58.5480609
],
[
-153.1384992,
58.5678286
],
[
-153.1470249,
58.5552926
],
[
-153.1820044,
58.5355625
]
],
[
[
-152.8741566,
58.7660471
],
[
-152.9882543,
59.4696836
],
[
-152.1322999,
60.0079718
],
[
-152.330171,
59.1676267
],
[
-152.8741566,
58.7660471
]
]
],
[
[
[
-172.7696055,
59.9963072
],
[
-171.8272619,
60.3517559
],
[
-173.4406927,
60.7880772
],
[
-173.4413238,
60.4223353
],
[
-172.7696055,
59.9963072
]
]
],
[
[
[
-169.6463302,
62.736964
],
[
-168.2509717,
63.332816
],
[
-172.2753008,
63.6094455
],
[
-172.0058757,
63.2057208
],
[
-169.6463302,
62.736964
]
]
]
]
},
"properties": {
"theme": "divisions",
"type": "division_area",
"version": 0,
"subtype": "country",
"class": "land",
"division_id": "example:division:country:us",
"names": {
"primary": "United States"
},
"country": "US"
}
}
{
"id": "example:division_area:maritime:country:fi",
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
24.1149326,
65.1739343
],
[
22.965913,
64.2461008
],
[
22.9611467,
64.2200974
],
[
20.1690736,
63.1704
],
[
20.1635668,
63.1664346
],
[
20.7968544,
62.025131
],
[
20.8113847,
61.9869932
],
[
20.7731398,
61.1334808
],
[
20.7714495,
61.1269079
],
[
19.2266918,
60.612911
],
[
19.2134721,
60.610071
],
[
19.0881715,
60.2028008
],
[
19.0832,
60.1916833
],
[
20.2889918,
59.4641746
],
[
20.2949231,
59.4620801
],
[
27.4560114,
60.223152
],
[
27.4566541,
60.2232587
],
[
31.5848283,
62.9070414
],
[
31.5867071,
62.9087094
],
[
29.9792123,
63.7533602
],
[
29.9718903,
63.7571676
],
[
30.5280169,
64.0488769
],
[
30.5535801,
64.1016818
],
[
29.6152439,
64.9174367
],
[
29.6110374,
64.9273269
],
[
29.7539876,
65.6093614
],
[
29.7218642,
65.6370848
],
[
30.1204275,
65.7484154
],
[
30.1193675,
65.7521935
],
[
29.0335178,
66.9246111
],
[
29.0331668,
66.9255206
],
[
30.0120699,
67.6649442
],
[
30.0170617,
67.6735368
],
[
28.7084312,
68.185236
],
[
28.6461349,
68.1963023
],
[
28.4446345,
68.5223038
],
[
28.433932,
68.539671
],
[
28.7947914,
68.8607869
],
[
28.8007886,
68.8692833
],
[
28.4291269,
68.9077986
],
[
28.4157885,
68.9154506
],
[
29.2950412,
69.4498488
],
[
29.3364956,
69.4783227
],
[
27.9604365,
70.089821
],
[
27.9593778,
70.0921111
],
[
25.9751031,
69.7083076
],
[
25.9712362,
69.707112
],
[
25.7752318,
69.0142604
],
[
25.7746414,
69.0134805
],
[
24.9050854,
68.5700172
],
[
24.9031658,
68.5545918
],
[
22.4047437,
68.721914
],
[
22.3745217,
68.7166666
],
[
21.6591391,
69.2559218
],
[
21.6270859,
69.2765883
],
[
20.5523258,
69.0600767
],
[
20.5486365,
69.0599735
],
[
23.6496681,
67.9616712
],
[
23.6511967,
67.9607085
],
[
23.3944185,
67.4851454
],
[
23.3944231,
67.4842768
],
[
23.9945079,
66.8234885
],
[
23.9956629,
66.822049
],
[
23.6455681,
66.3021131
],
[
23.6456201,
66.3013903
],
[
24.1526454,
65.8629123
],
[
24.152978,
65.862572
],
[
24.1149326,
65.1739343
]
]
]
},
"properties": {
"theme": "divisions",
"type": "division_area",
"version": 0,
"subtype": "country",
"class": "maritime",
"division_id": "example:division:country:fi",
"names": {
"primary": "Suomi",
"common": {
"en": "Finland"
}
},
"country": "FI"
}
}
{
"id": "example:division_area:land:region:it-umbria",
"type": "Feature",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
12.4306287,
43.6064043
],
[
12.4084345,
43.6022829
],
[
12.4078047,
43.602136
],
[
12.4302993,
43.5912531
],
[
12.4312128,
43.5913639
],
[
12.4306287,
43.6064043
]
]
],
[
[
[
12.8900745,
43.059502
],
[
12.7728713,
43.4565236
],
[
12.7726151,
43.4567887
],
[
12.6198957,
43.4169405
],
[
12.6194173,
43.4165862
],
[
12.5000805,
43.5212743
],
[
12.4998147,
43.521458
],
[
12.3320842,
43.5243232
],
[
12.3317959,
43.5245007
],
[
12.3701584,
43.6119045
],
[
12.3700595,
43.611996
],
[
12.2138805,
43.6107953
],
[
12.2138068,
43.6108907
],
[
12.0252105,
43.4155739
],
[
12.0252212,
43.4150694
],
[
12.1309371,
43.2932054
],
[
12.1311294,
43.2930826
],
[
12.2238695,
43.2961562
],
[
12.2246532,
43.2957978
],
[
11.9259547,
43.1499195
],
[
11.9251852,
43.1493546
],
[
11.9795832,
43.0537307
],
[
11.9827957,
43.049902
],
[
11.9593386,
42.8687177
],
[
11.9593484,
42.868682
],
[
11.8923677,
42.843515
],
[
11.8920337,
42.8434469
],
[
11.9770061,
42.7649469
],
[
11.9794818,
42.7645853
],
[
11.9410581,
42.6836657
],
[
11.9413298,
42.6833009
],
[
12.2038508,
42.6606588
],
[
12.2043355,
42.6604606
],
[
12.2901554,
42.4919867
],
[
12.290409,
42.491639
],
[
12.4187877,
42.4977764
],
[
12.4190453,
42.4976526
],
[
12.4129933,
42.4269008
],
[
12.4136503,
42.4255981
],
[
12.529869,
42.364831
],
[
12.531277,
42.3647769
],
[
12.8909742,
42.6141819
],
[
12.8927853,
42.6150727
],
[
13.1541942,
42.650734
],
[
13.1553015,
42.6513206
],
[
13.2590757,
42.7894895
],
[
13.2595251,
42.789692
],
[
13.2359026,
42.8672651
],
[
13.2352706,
42.8676862
],
[
13.1612307,
42.8318577
],
[
13.1608634,
42.831898
],
[
13.0546323,
42.9196792
],
[
13.0544191,
42.9201958
],
[
12.9765402,
42.8697582
],
[
12.9761569,
42.8698022
],
[
12.8900745,
43.059502
]
]
]
]
},
"properties": {
"theme": "divisions",
"type": "division_area",
"version": 0,
"subtype": "region",
"class": "land",
"division_id": "example:division:country:it",
"names": {
"primary": "Umbria"
},
"country": "IT",
"region": "IT-55"
}
}