Skip to main content

DivisionBoundary

Boundaries represent borders between divisions of the same subtype.

Some boundaries may be disputed by the divisions on one or both sides.

Fields

NameTypeDescription
idIdA 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.
bboxbbox (optional)An optional bounding box for the feature
geometrygeometryBoundary line or lines

Allowed geometry types: LineString, MultiLineString
theme"divisions"
type"division_boundary"
versionFeatureVersion
subtypePlaceTypeadmin_level is required when subtype is one of: county, macrocounty, region, macroregion, dependency, country
country is required when subtypecountry
country is forbidden when subtype = country
classBoundaryClass
is_landboolean (optional)A boolean to indicate whether or not the feature geometry represents the land-clipped, non-maritime boundary. The geometry can be used for map rendering, cartographic display, and similar purposes.

strict=True

Exactly one of is_land, is_territorial must be true
is_territorialboolean (optional)A boolean to indicate whether or not the feature geometry represents Overture's best approximation of this place's maritime boundary. For coastal places, this would tend to include the water area. The geometry can be used for data processing, reverse-geocoding, and similar purposes.

strict=True

Exactly one of is_land, is_territorial must be true
division_idslist<Id>Identifies the two divisions to the left and right, respectively, of the boundary line. The left- and right-hand sides of the boundary are considered from the perspective of a person standing on the line facing in the direction in which the geometry is oriented, i.e. facing toward the end of the line.

The first array element is the Overture ID of the left division. The second element is the Overture ID of the right division.

References Division (boundary of)
Minimum length: 2
Maximum length: 2
All items must be unique. (UniqueItemsConstraint)
countryCountryCodeAlpha2 (optional)ISO 3166-1 alpha-2 country code of the country or country-like entity that both sides of the boundary share.

This property will be present on boundaries between two regions, counties, or similar entities within the same country, but will not be present on boundaries between two countries or country-like entities.

country is required when subtypecountry
country is forbidden when subtype = country
regionRegionCode (optional)ISO 3166-2 principal subdivision code of the subdivision-like entity that both sides of the boundary share.

This property will be present on boundaries between two counties, localadmins or similar entities within the same principal subdivision, but will not be present on boundaries between different principal subdivisions or countries.
admin_levelAdminLevel (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
is_disputedboolean (optional)Indicator if there are entities disputing this division boundary. Information about entities disputing this boundary should be included in perspectives property.

This property should also be true if boundary between two entities is unclear and this is "best guess". So having it true and no perspectives gives map creators reason not to fully trust the boundary, but use it if they have no other.

strict=True

Constraints

  • Exactly one of is_land, is_territorial must be true
  • admin_level is required when subtype is one of: county, macrocounty, region, macroregion, dependency, country
  • country is required when subtypecountry
  • country is forbidden when subtype = country

Examples

ColumnValue
id2bdf68e4-860d-3d8c-a472-ccf439a5302a
bbox.xmin-147.06483459472656
bbox.xmax-147.04847717285156
bbox.ymin-15.4231538772583
bbox.ymax-15.151169776916504
geometryLINESTRING (-147.064823 -15.4231537, -147.0519131 -15.2885069, -147.048482 -15.1511701)
themedivisions
typedivision_boundary
version1
sources[0].property
sources[0].datasetOpenStreetMap
sources[0].record_idr6063055@9
sources[0].update_time2023-07-20T00:28:40Z
sources[0].confidencenull
sources[0].betweennull
sources[1].property
sources[1].datasetOpenStreetMap
sources[1].record_idr6063063@12
sources[1].update_time2023-07-20T00:28:40Z
sources[1].confidencenull
sources[1].betweennull
subtypecounty
classmaritime
is_landfalse
is_territorialtrue
division_ids["ae266459-63a4-4508-8295-0101e27d039b", "d4a6873d-885a-4f2a-bc0f-37e9d9e874e4"]
countryPF
regionnull
is_disputedfalse
perspectivesnull