GuidesAPI Reference
Guides

boundaries

Content: default
Geometry: line
Zoom: 0–17

The following figure illustrates an example of boundaries.

Example of European Boundaries

Properties

kind | kind:{country_code} | kind_detail | border_style | name:left | name:right | name:left:{language_code} | name:right:{language_code}

Common properties

min_zoom | sort_rank

Common properties specific to Japan - core map

source


kind

Type: string
Optional

Boundaries can be one of the options listed below. For disputed borders, see kind:{country_code}. When kind:{country_code} is present, kind may be absent.

Values

ValueZoomDescription
country0–17National boundary line.
disputed0–17Boundary where two or more countries have conflicting territorial claims.
region2–17Regional boundary such as a state or province.

Values specific to Japan - core map

ValueZoomDescription
locality9–17City boundary in Japan, corresponding to admin_level=7 in OpenStreetMap.
oaza13–17Subdistrict boundary in Japan. An ōaza is a large rural subdivision within a Japanese municipality.
aza14–17Small administrative zone boundary in Japan. An aza is a subdivision within an ōaza.
block15–17Block boundary in Japan.

Type: string
Present when kind_detail is: 2, 4

An alternate for kind according to the geopolitical view of a country.

ValueDescription
countryNational boundary line from the perspective of the given country's viewpoint.
disputedDisputed boundary from the perspective of the given country's viewpoint.
regionRegional boundary from the perspective of the given country's viewpoint.
unrecognized_countryA line treated as a country boundary in the default international view, but not recognized as such from the given country's viewpoint.
unrecognized_disputedA line treated as disputed in the default international view, but reclassified from the perspective of the given country's viewpoint.
unrecognized_regionA line treated as a regional boundary in the default international view, but not recognized as such from the given country's viewpoint.

kind_detail

Type: int
Always present

This is an integer that maps kind to more specific information about the feature.

Values

ValueDescriptionAssociated kind
2For countries.country, disputed
4For states.disputed, region

Values specific to Japan - core map

ValueDescriptionAssociated kind
7For cities.locality
9For subdistricts.oaza
10For further zones.aza
11For further zones.block

border_style

Type: string
Always present

ValueDescriptionAssociated kind
dashedDashed line style, used for unresolved or ceasefire boundary lines.unrecognized_country, unrecognized_disputed, unrecognized_region
dottedDotted line style, used for disputed boundary lines.disputed
solidSolid line style, used for internationally established boundary lines.country
undefinedBorder style is not defined.

name:left

Type: string
Present when kind_detail is: 2, 4

The name to display on the left side of the border when traversing the line geometry from start to end. For more information, see Feature names.


name:right

Type: string
Present when kind_detail is: 2, 4

The name to display on the right side of the border when traversing the line geometry from start to end. For more information, see Feature names.


name:left:{language_code}

Type: string
Present when kind_detail is: 2, 4

The localized name to display on the left side of the border. For more information, see Name localization.


name:right:{language_code}

Type: string
Present when kind_detail is: 2, 4

The localized name to display on the right side of the border. For more information, see Name localization.

Common properties


min_zoom

See min_zoom.


sort_rank

Type: int
Always present

The ordering of features, which determines which features are rendered "on top of" other features, can be an important issue when rendering maps. To assist map rendering, there is a sort_rank property on some features that suggests in what order the features should appear.

A feature with a higher sort_rank value is displayed on top of feature with a lower sort_rank value.

Values

ValueAssociated kind
256region
261disputed
262country

Values specific to Japan - core map

ValueAssociated kind
450block
451aza
452oaza
453locality

Common properties specific to Japan - core map


source

See source.