Land use refers to the way humans utilize the land for different economic and cultural activities, including agriculture, residential living, industrial operations, mining, and recreation.
In HERE Vector Tile API, the landuse layer provides information about the various types of land use in a particular geographic region. This layer is crucial for map developers because it enables distinguishing between different land use types with ease and provide users with a better understanding of the geographic areas they are exploring.
The following figure illustrates sample features of the landuse layer when rendered:
The layer content has the following definition:
Layer name: landuse
Geometry types: point, polygon, line
The following sections provide an overview of the landuse layer in the HERE Vector Tile API:
Every feature in the landuse layer includes a set of properties that define it, regardless of the feature type it represents.
These properties are referred to as common properties in the Tilezen schema. For more information, see Tile layers.
name - The name of the landuse feature, if available. The name might be provided in multiple languages, depending on the feature and the available data.
id - A unique identifier for the landuse feature.
kind - The type of the landuse feature, for example, industrial, urban, park, and so on.
sort_rank - A value used to prioritize the display order of different types of landuse features on the map. A landuse feature with a higher sort_rank value is displayed on top of a landuse feature with a lower sort_rank value.
area - The area of the landuse feature in square meters, as measured in spherical Mercator projection. This property is valid for polygon features only.
min_zoom - The recommended minimum zoom level at which the landuse feature should be displayed.
The following figure shows examples of landuse features and how they can be rendered on a map:
Some landuse features include properties that are specific only to their corresponding landuse kind. For example, the toll property is available only for landuse features whose kind corresponds to polygonal roads.
These properties are referred to as common-optional properties in the Tilezen schema. For more information, see Tile layers.
toll - An optional boolean property that indicates if a fee must be paid by general traffic to travel the feature. This property can only have the following values: true and is available only for such polygonal road kinds as expressway, urban_expressway, and other_road.
The kind and sort_rank values are important properties of the landuse features in the HERE Vector Tile API. The kind property specifies the type of landuse feature, while the sort_rank property indicates its prominence on the map.
A polygonal road is a type of road for which a polygon is used to define the extent and shape of the road segment. Such roads are commonly used to depict roads that deviate from the traditional linear shape, such as roundabouts, cul-de-sacs, or curved road segments.
The core layer in Japan-specific polygonal roads contains kind values with limited coverage at zoom 14 and higher, which allow for a detailed polygonal representation of roads. These values can be found in the is_present_in_landuse property of the roads feature. For more information, see Roads (transportation).
The following values are included:
other_road (sort_rank: 378) - Roads like tertiary, also present as centerlines in the roads layer.
major_road (sort_rank: 380) - Roads like secondary, also present as centerlines in the roads layer.
national_road (sort_rank: 381) - Roads like primary, also present as centerlines in the roads layer.
urban_expressway (sort_rank: 381) - Urban expressway roads like motorway, also present as centerlines in the roads layer.
expressway (sort_rank: 384) Expressway roads like motorway, also present as centerlines in the roads layer.
road_in_restricted_area (sort_rank: 400) - Roads in restricted areas like parks, pedestrian areas, or golf courses, not present as centerlines in the roads layer.
road_under_construction (sort_rank: 401) - Roads under construction, also present as centerlines in the roads layer.
The following figure shows sample landuse features representing polygonal roads in Japan:
Additional kind information
Landuse kind_detail values provide additional information about the landuse feature type. They are used to describe the specific characteristics of a land use area.
For example, an object of whose kind property is other_road, might have the kind_detail value set as service to indicate that the road is designated a service function, such as a parking lot, gas station, or other amenities associated with road usage.
The following list provides the common kind_detail values:
environmental - For environmental zones.
congestion - For congestion zones.
The following list provides Japan-specific kind_detail values within the core layer:
primary - For national_road kind.
secondary_city - For major_road kind.
tertiary - For major_road kind.
tertiary_city - For major_road kind.
service - For other_road kind.
Low zoom consolidation
At zoom levels lower than 12, the HERE Vector Tile API combines certain types of landuse features to reduce unnecessary detail and encourage adjacent landuse features to merge together more seamlessly.
The id property is not available for consolidated landuse features.
The following mappings are currently in place:
commercial is consolidated into urban_area.
industrial is consolidated into urban_area.
parking is consolidated into urban_area.
For more information about other layer feature types available in the HERE Vector Tile API, see Tile Layers.