Tile Layers

The data in the HERE Vector Tile Service is organized in layers according to the definitions specified by the Tilezen open-source project started by Mapzen. The HERE Vector Tile Service has some changes and simplifications on top of that layer definition, but all these changes are backwards compatible and comply with the specification. Specifically, all mandatory parameters and all must-have values are still included. Some optional parameters have been removed from the HERE Vector Tile Service to better align the layer structure with the HERE Vector Tile Service own data and processing logic.

The sections below include all the information necessary to understand the layer structure. The HERE Vector Tile Service uses the same structure as the original layer definition to make it easier to find the changes, and follows the same SEMANTIC VERSIONING statement as originally formulated by Tilezen.

Need help displaying vector tiles in a map? Here are several examples using the HERE Vector Tile Service to style in your favorite graphics library including Harp.gl, HERE Maps API for JavaScript, Mapbox, and Tangram.

Overview

Data Sources and Attribution

The HERE Vector Tile Service uses data from HERE. For more information, see Required Copyright Notice.

Source Property Usage in Tiles

The property source is generally omitted in all tiles. Assume that the value is here.com unless stated otherwise.

However, for some regions of the world within the core layer parameter (for example, Japan), this property is present, and the property value indicates the data source provider. In case of Japan, the value is ipc.

Definition of Terms

  • common - These layers, properties, and kinds are generally available across all features in a response.
    • Establishes basic selection of features and their arrangement into specific named layers.
    • Core properties needed for display and labeling of features:
      • Special bits that make vector tile content interoperable, including kind, kind_detail, landuse_kind, min_zoom, and sort_rank.
      • Fundamental properties like name (including localized names) that are included in almost every feature.
  • common-optional - These are meant to be part of a common set but may not be present because they aren't relevant or because we don't have the data (primarily feature properties, but could also be layers).
    • Used to refine feature selection.
    • Lightly transformed interoperable properties based on original data values.
    • Fundamental properties like population.
  • optional - These are properties of a specific, less important kind, or generally present across kinds, but only in exceptional cases.
    • Often used to "decorate" features already selected for display.

Feature Names

Most features in a vector tile include a basic name property in the common list of properties, such as:

  • name - Generally the name the locals call the feature, in the local language script.

This definition supports several additional name-related properties (optional):

  • name:short - For example, CA for California.
  • name:left - The name to be shown on the left side of the border.
  • name:right - The name to be shown on the right side of the border.

There are some layers in which the name property is considered optional. For example, for features in the boundaries layer, instead of name, the properties name:left and name:right are used for oriented labeling on the appropriate side of the boundary line. This allows the labeled polygon's text to appear inside that polygon consistently. The example below illustrates the usage of the left and right properties. In this case, the country labels in the boundaries layer would include something like:

  kind : country
  name:left : Қазақстан
  name:right : Россия

This means that for that particular location, if you are using local languages to render your map, you should label the left side of the border with "Қазақстан" and the right side with "Россия".

Name Localization

HERE includes all language variants of the name:* values to enable full internationalization when available.

Language variants are identified by an ISO 639-1 two-letter language code, for example, en for English. As a result, the country of Greece would use something like:

  kind : country
  name : Ελλάδα
  name:en : Greece

Localized Name Properties (common-optional)

  • name:* - The name to call the feature in a localized language indicated by its language code. For example, name:en : Germany.
  • name:left:* - The localized name to be shown on the left side of the border.
  • name:right:* - The localized name to be shown on the right side of the border.

Geometry Types

Individual vector tile layers can include mixed geometry types. This is common in the landuse, water, and buildings layers.

A tile geometry can be one of three types:

  • point - point, multipoint
  • line - linestring, multilinestring
  • polygon - polygon, multipolygon

Data Updates

The vector tile content is updated regularly, sometimes multiple times per day.

Changelog

The current version of the HERE vector tile layer definition is based on Tilezen's data model v1.5.0.

Feature Ordering

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. Lower numbers indicate that features should appear "towards the back" and higher numbers indicate "towards the front". These numbers are consistent across layers.

The layers that include sort_rank on their features are:

  • boundaries
  • buildings
  • landuse
  • roads
  • transit
  • water

Layer Reference

HERE includes ten (10) layers:

All of these layers are part of the tile in the response when you use the API to make a request within the base layer parameter. For more information on the available endpoints and parameters, see the Swagger spec.

Boundaries

The following figure illustrates an example of boundaries.

Example of European Boundaries
Figure 1. Example of European Boundaries

The layer's content is defined as follows.

  • Layer name: boundaries
  • Geometry types: line

Boundary Properties (common)

The following properties are used to define a boundary.

  • kind - Boundaries can be one of the options listed below. For disputed borders, see kind:xx below.
  • kind_detail - This property maps a kind value to more specific information about admin level. For possible values, see below.
  • sort_rank - This property is a suggestion in which order to render features. The value is an integer where smaller numbers indicate that features should be "behind" features with larger numbers.
  • min_zoom - This property indicates a suggested minimum zoom at which the boundary line should become visible.

Boundary Properties (common-optional)

  • kind:xx - An alternate for kind according to the political viewpoint of a country, where xx is a lowercase ISO 3166-1 alpha-2 code (for example, de or es). To show features according to a particular viewpoint, use kind:xx if it exists; otherwise, fall back to kind.

    The following are code examples of the India-Pakistan border in different viewpoints.

    International view:

    kind: disputed
    kind:pk: unrecognized_disputed
    kind:in: unrecognized_disputed
    

    India view:

    kind:in: country
    kind:pk: unrecognized_country
    

    Pakistan view:

    kind:in: unrecognized_country
    kind:pk: country
    
  • name:left - See Feature Names above.

  • name:left:* - See Name Localization above.
  • name:right - See Feature Names above.
  • name:right:* - See Name Localization above.

Boundary kind and sort_rank Values

  • country - 262
  • disputed - 261
  • region - 256

Boundary kind:xx Values

  • country
  • region
  • disputed
  • unrecognized_country
  • unrecognized_region
  • unrecognized_disputed

Boundary kind_detail Values

For admin level:

  • AdminLevelCountry = 2
  • AdminLevelState = 4

Buildings and Addresses

The following figure illustrates an example of buildings rendered from the data.

Example of Buildings in San Francisco
Figure 2. Example of Buildings in San Francisco

The layer content is defined as follows.

  • Layer name: buildings
  • Geometry types: point, polygon

This layer includes polygons that represent building footprints, building label placement points, building_part features, and address points. All buildings and available address points appear at zoom 14 and higher.

Note

Building geometries, like most geometries, are clipped to the bounds of the tile, even if the building extends beyond the tile. This means that it might be necessary to assemble a geometry from several neighboring tiles to recreate a full building. Some buildings are exceptionally large and span many tiles, which can make rendering complex.

Building Properties (common)

The following properties are used to define a building.

  • name - Generally the name the locals call the feature, in the local language script.
  • kind - Describes a simple or complex building that might have various parts. For possible values, see below.
  • kind_detail - A type of building. For possible values, see below.
  • sort_rank - This property is a suggestion in which order to render features. The value is an integer where smaller numbers suggest that features should be "behind" features with larger numbers. The value for all buildings is 475.
  • min_zoom - This property contains a suggested minimum zoom at which the building should become visible.

Building Properties (common-optional)

The following optional properties are used to define additional information about a building.

  • addr_housenumber - A string value of the building number. Filled for kind address.
  • height - Elevation of the roof above the ground. Indicated in meters with one decimal point, where available.
  • min_height - Elevation of the building's bottom above the ground if the bottom level of the building or its part is not located on the ground. Indicated in meters with one decimal point, where available.
  • has_landmark - true only if the building or a part of the building is available in the 3D Landmarks layer on the HERE platform. There is no false value, as the property is not present in that case.
  • layer - This property indicates vertical ordering.

Building kind Values

  • building - polygon
  • building_part - polygon, might have different height and min_height attributes
  • address - point, contains the addr_housenumber attribute

Building kind_detail Values

Note

Additional kind_detail values are provided from the POI kind values in case one is not available from the building feature. This means that you can see any POI kind value as a building kind_detail value.

  • art - cultural buildings: library, museum, or theatre
  • arts_centre - venues where arts are performed or exhibited
  • commercial - business or commerce buildings: bank, business facility, hotel, or motel
  • educational_institution - university, college, or school buildings
  • fire_station - emergency services
  • government - post offices, embassies, city halls, courts, government offices, or county councils
  • historical - historical monuments
  • hospital - medical service or hospital buildings
  • industrial - buildings where some industrial processes take place
  • landmark - buildings that are relevant landmarks, used for navigation, recognizable for users, and often visible from long distances
  • mixed_use - buildings with a combination of residential, commercial, cultural, institutional, or industrial purposes.
  • park - parks or leisure buildings: bar, pub, casino, park area, or golf course
  • parking - buildings constructed primarily for the purpose of parking cars, which can be single-storey or multi-storey
  • police - police stations
  • religion - buildings built as places of worship: church, mosque, temple, synagogue, ashram, or gurdwara
  • residential - buildings used primarily for residential purposes
  • retail - buildings used primarily for selling goods to the general public
  • sports - sports center or activity buildings
  • tourism - tourist attractions or tourist offices
  • trade - facilities used for large events such as trade shows, trade fairs, or conventions
  • transportation - buildings used for public transportation

Building kind_detail Values for Certain Areas in core

The following list of kind_detail values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile Service, see Layer Parameter.

Below are these kind_detail values within the core layer parameter for Japan:

  • airport - a facility that provides a designated area for the landing and takeoff of aircraft and the dispensing and loading of aircraft contents and passengers
  • bank - a business that specializes in the maintenance, lending, exchange, or issue of money for its customers (for example, central banks, consumer banks, credit unions)
  • bar - a nightlife or entertainment business that sells alcoholic beverages and may serve food or light meals
  • books - a retail business that primarily sells books
  • bridge - a bridge building
  • bus_station - a public transport facility that provides a hub in the intercity bus service network
  • car - a business that sells cars
  • car_rental - a business that provides automobiles to rent for short periods of time for a fee
  • car_repair - a business that provides automotive services, usually a major chain, for the repair or maintenance of a motor vehicle
  • casino - a gaming business that provides any variety of legal gambling
  • church - a religious place of worship for those of the Christian faith
  • cinema - a business that provides a place for showing movies to a large audience
  • civic - a government building that provides space to the public for community events, special events, seasonal programs, organized classes, as well as a general space for rent
  • clothes - a retail business that sells general apparel, garments, and/or fashion accessories for men, women, and children
  • convenience - a retail business that sells a combination of food and other products, and may or may not also sell fuel
  • courthouse - a government building where a court of law is held
  • department_store - a retail business that sells a wide variety of merchandise and organized into various departments for sales and administrative purposes
  • electronics - a business that sells consumer electronics and electronic entertainment equipment
  • embassy - a government building that houses diplomatic representatives of foreign countries
  • factory - a factory building
  • fuel - a business that sells fuel, oil, and other motoring supplies for drivers of automotive vehicles
  • grocery - a retail business that sells a large variety of different types of food, including fresh produce, packaged goods, bakery items, and meat products
  • hotel - a business that provides overnight lodging to the public and usually provides meals, entertainment, and various personal services
  • inclined_rail_station - a public transport facility that provides a hub for passengers travelling along an inclined cable-guided railway
  • library - a place in which literary, musical, artistic, or reference materials are kept for use and circulation, but are not for sale
  • mall - a complex of businesses, such as retail stores and restaurants, grouped together and sharing common services
  • marina - a facility that provides a dock or basin with moorings and supplies for yachts, small boats, or pleasure crafts
  • monorail_station - a public transport facility that provides a hub for passengers travelling along an elevated monorail railway
  • mosque - a religious place of worship for those of the Islamic faith
  • museum - a business with the primary function of the preservation and exhibition of artistic, historical, or scientific objects
  • nightclub - a nightlife or entertainment business that provides evening entertainment generally until the very early morning (for example, dance club, lounge, or wine bar)
  • office - a facility that contains business offices
  • passageway - a horizontal walkway
  • pharmacy - a retail business that sells prescription and non-prescription medications in addition to other general health remedies
  • post_office - a business that processes and transmits the mail for a specific area; this can include a local branch or a national office
  • restaurant - a business that sells refreshments and prepared meals and may provide seating and/or pickup/takeout services
  • school - an institution that provides basic elementary or secondary education to children and teenagers
  • ski - a business that sells skiing related items, such as skis, ski boots, clothing, and other accessories
  • synagogue - a religious place of worship for those of the Jewish faith
  • staircase - a facility for pedestrian movement
  • temple - a religious place of worship that may be dedicated to, but is not limited to, Hinduism, Buddhism, Taoism, Sikh, Jain, Ayyavazhi
  • theatre - a business that presents performing arts
  • toll_booth - a public transport feature that represents the structure along an expressway or thoroughfare where an automobile must pay a fee in exchange for usage of the roadway
  • townhall - a government building that houses the seat of an incorporated government for a municipality, city, borough, town, and other administrative unit
  • train_station - a public transport facility that provides a hub for passengers and goods travelling between minor and major cities along the railway network
  • university - a university building
  • winery - a landmark or attraction business that makes wine and may provide tours or wine tastings, which are open to the public

Earth

The following figure illustrates an example of a view of the earth rendered from the data.

Continent View
Figure 3. Continent View

The layer content is defined as follows.

  • Layer name: earth
  • Geometry types: point

Note

There is a key difference when compared to the Tilezen's implementation, as HERE only includes label positions and label texts for islands and continents. This means that HERE does not include the polygon and line geometry types for this layer.

Earth Properties (common)

The following properties are used to define a view of the earth.

  • name - This property contains the text to display in label placement points.
  • id - This is an ID used internally within HERE.
  • kind - Earth views can be one of the options listed below.

Earth kind Values

  • continent - point, intended for label placement only
  • island - point, intended for label placement only

Landuse

Landuse polygons represent parks, forests, universities, airports, sports facilities and residential, commercial, industrial and other areas.

The following figure illustrates an example of such a polygon when rendered.

Central Park in New York
Figure 4. Central Park in New York

The layer content is defined as follows.

  • Layer name: landuse
  • Geometry types: point, polygon, line

Landuse Properties (common)

The following properties are used to define a landuse polygon.

  • name - Generally the name the locals call the feature, in the local language script.
  • id - This is an ID used internally within HERE.
  • kind - Landuse polygons can be one of the options listed below.
  • sort_rank - This property is a suggestion for which order to draw features. The value is an integer where smaller numbers suggest that features should be "behind" features with larger numbers.
  • area - This property is in square meters (spherical Mercator, no real-world). It is valid for polygon features only.
  • min_zoom - This property contains a suggested minimum zoom at which the landuse polygon should become visible.

Landuse Properties (common-optional)

  • 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.
  • kind_detail - For possible values, see the kind_detail list below.

Landuse kind and sort_rank Values

Here are the possible landuse kind values ordered by sort_rank:

  • urban_area - 16 (for neighbourhood boundaries)
  • reservation - 17
  • national_park - 18 (for state parks, national parks, and national forests)
  • glacier - 29
  • forest - 31 (for woodlands)
  • urban - 32 (for built-up areas)
  • military - 33
  • low_emission_zone - 40 (for environmental zones), 41 (for congestion zones)
  • university - 42
  • park - 43 (for city parks)
  • allotments - 44
  • beach - 45
  • aerodrome - 46
  • railway - 47
  • harbour - 48
  • theme_park - 54
  • industrial - 55
  • commercial - 56
  • zoo - 57
  • hospital - 60
  • golf_course - 62
  • runway - 79
  • sports_centre - 81
  • cemetery - 92
  • pedestrian - 112
  • parking - 123
  • water_park - 124

Landuse kind and sort_rank Values for Certain Areas in core

The following list of kind and sort_rank values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile Service, see Layer Parameter.

Below are these kind values ordered by sort_rank within the core layer parameter for Japan:

  • underground_city - 0 (for underground passages)
  • imperial_facility - 24 (for imperial facilities such as palaces with adjacent green areas)
  • flood_prone_area - 32
  • railway_station - 47 (for simplified polygonal representation of railway station areas at lower zooms 13-15)
  • paved_area - 89 (for generic paved areas)
  • sand - 89 (for sandy soils, including beaches and golf course sand traps)
  • place_of_worship - 91 (for different religious areas)
  • school - 93
  • grass - 125 (for green tracts such as lawns)
  • wetland - 220 (for swamps)
  • breakwater - 224
  • steps - 274 (for stairs)
  • block - 385 (for city block polygons)
  • city_divider - 385 (for traffic dividers at the toll booth)
  • pedestrian - 386 (for sidewalks in main streets; a temporary sort rank to place on top of the water)
  • institutional_office - 395 (for institutional offices)
  • accomodation_facility - 396 (for accomodation facilities)
  • outdoor_facility - 397 (for outdoor facilities)
  • grassland - 401 (for afforested areas, green areas that are not part of forest, and golf course fairways to differenciate from the rest of green areas)
  • tunnel_entrance - 402 (for tunnel entrances and exits)
  • tunnel line - 403 (for tunnel outlines)
  • divider - 405 (for traffic dividers)
  • transportation - 406 (for generic transportation infrastructure)

Additionally, there are a few kind values with limited coverage in Japan at zoom 14 and higher for detailed polygonal representation of roads - see is_present_in_landuse in the road properties:

  • other_road - 378 (for other roads such as tertiary, also represented as centerlines in the roads layer)
  • major_road - 380 (for major roads such as secondary, also represented as centerlines in the roads layer)
  • national_road - 381 (for national roads such as primary, also represented as centerlines in the roads layer)
  • urban_expressway - 381 (for urban expressway roads such as motorway, also represented as centerlines in the roads layer)
  • expressway - 384 (for expressway roads such as motorway, also represented as centerlines in the roads layer)
  • road_in_restricted_area - 400 (for roads in restricted areas such as parks, pedestrian areas, or golf courses, NOT represented as centerlines in the roads layer)

Landuse kind_detail Values for Certain Areas in core

Below are these kind_detail values within the core layer parameter for Japan:

  • 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 zooms lower than 12, the HERE Vector Tile Service consolidates some landuse kinds to reduce the amount of superfluous detail and give adjacent landuse areas a better chance to merge together. Note that the id property is not available for consolidated landuses.

The current mappings are:

  • commercial -> urban_area
  • industrial -> urban_area
  • parking -> urban_area

Places

The following figure illustrates an example of a place rendered from the data.

Sample Places in Sweden
Figure 5. Sample Places in Sweden

The layer content is defined as follows.

  • Layer name: places
  • Geometry types: point

Places have kind values of country, with other values added dynamically, depending on factors such as area or population, starting at zoom 3 for region and starting at zoom 8 for locality. Specific locality and region types are added to the kind_detail tag.

Place Properties (common)

The following properties are used to define a place.

  • name - Generally the name the locals call the feature, in the local language script.
  • id - This is an ID used internally within HERE.
  • kind - Places can be one of the options listed below.
  • min_zoom - This property contains a suggested minimum zoom at which the place should become visible.

Place Properties (common-optional)

The following properties are used to define additional information about a place.

  • country_capital - This property is true for country capitals and applies only to kind locality.
  • region_capital - This property is true for state capitals and applies only to kind locality.
  • county_capital - This property is true for county capitals and applies only to kind locality.
  • kind_detail - Places can be one of the options listed below.
  • population - This property contains a population integer value and applies only to kind locality.
  • iso_code - This property contains the ISO 3166-1 alpha-2 two-letter country code and applies only to kind country.

Place kind Values

  • country
  • region
  • locality
  • borough
  • neighbourhood
  • microhood - administrative zones that are smaller than neighbourhood (for example, a block or parcel number in Japan)

Place kind_detail Values

For features of kind locality:

  • city (population 100,000 and more)
  • town (population 10,001 up to 100,000)
  • village (population 201 up to 10,000)
  • hamlet (population 200 and less)

For features of kind region:

  • state
  • province

For features of kind microhood, which are only applicable for certain areas of the world within the core layer parameter:

  • block - a block number, which requires a house number to determine the address
  • parcel - a parcel number, which does not require a house number to determine the address

Points of Interest

The following figure illustrates an example of points of interest (POIs) rendered from the data.

Sample POIs in Madrid
Figure 6. Sample POIs in Madrid

The layer content is defined as follows.

  • Layer name: pois
  • Geometry types: point

POI Properties (common)

The following properties are used to define a POI.

  • name - Generally the name the locals call the feature, in the local language script.
  • id - An internal HERE ID or places id that can be used in other HERE Services to find additional information about the POI.
  • kind - POI types can be one of the options listed below.
  • is_train - true only if it's a train station. There is no false value, as the property is not present in that case.
  • min_zoom - This property contains a suggested minimum zoom at which the POI should become visible.
  • pds_category - A string property that matches the Category ID from the PDS category system. For possible pds_category values, see below.
  • elevation - Mountain peak height in meters, applicable only for kind peak.

POI kind Values

  • airport
  • artwork
  • attraction
  • beach
  • border_crossing
  • ferry_terminal
  • garden
  • golf_course
  • hamlet
  • historical
  • hospital
  • museum
  • motorway_junction
  • named_place
  • neighborhood
  • park
  • peak
  • sports_centre
  • station
  • taxi
  • theme_park

POI kind Values for Certain Areas in core

The following list of kind values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile Service, see Layer Parameter.

Below are these kind values within the core layer parameter for Japan:

  • intersection - defines a point with roads intersection
  • parking - defines a parking lot in hotel, payed hourly or near a large retail store

POI pds_category Values

Note

pds_category does not exactly correspond to kind, as, for example, a train station, commuter rail station, commuter train and subway all have the station kind, an amusement park has the theme_park kind, and a tourist attraction has the attraction kind.

  • 200-2200-0020 - performing arts (artwork kind)
  • 300-3000-0023 - tourist attraction (attraction kind)
  • 300-3000-0025 - historical monument (historical kind)
  • 300-3100-0000 - museum (museum kind)
  • 300-3100-0026 - science museum (museum kind)
  • 300-3100-0027 - children's museum (museum kind)
  • 300-3100-0028 - history museum (museum kind)
  • 300-3100-0029 - art museum (museum kind)
  • 350-3510-0238 - mountain peak (peak kind)
  • 400-4000-4581 - airport (airport kind)
  • 400-4100-0035 - train station (station kind)
  • 400-4100-0037 - subway (station kind)
  • 400-4100-0039 - commuter train station (station kind)
  • 400-4100-0045 - boat ferry (ferry_terminal kind)
  • 400-4100-0046 - rail ferry (ferry_terminal kind)
  • 400-4100-0047 - taxi stand (taxi kind)
  • 400-4100-0226 - motorway junction (motorway_junction kind)
  • 550-5510-0202 - park (park kind)
  • 550-5510-0203 - sports field (sports_centre kind)
  • 550-5510-0204 - garden (garden kind)
  • 550-5510-0205 - beach (beach kind)
  • 550-5520-0207 - amusement park (theme_park kind)
  • 800-8000-0159 - hospital (hospital kind)
  • 800-8100-0172 - border crossing (border_crossing kind)
  • 800-8600-0180 - sports complex (sports_centre kind)
  • 800-8600-0193 - golf course (for golf_course kind)
  • 900-9100-0214 - hamlet (hamlet kind)
  • 900-9100-0215 - named place (named_place kind)
  • 900-9100-0216 - neighborhood (neighborhood kind)
  • 900-9400-0402 - roads intersection (intersection kind)
  • 800-8500-0178 - parking lot (parking kind)

POI pds_category Values for Certain Areas in core

The following list of pds_category values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile Service, see Layer Parameter.

Below are these pds_category values within the core layer parameter for Japan:

  • 900-9400-0402 - roads intersection (intersection kind)
  • 800-8500-0178 - parking lot (parking kind)

Roads (Transportation)

The following figure illustrates an example of a road rendered from the data.

Sample Roads in London
Figure 7. Sample Roads in London

The layer content is defined as follows.

  • Layer name: roads
  • Geometry types: line, point

This layer contains information about all kinds of transportation including, but not limited to, highways, major roads, minor roads, paths, railways and ferries. Sort them with sort_rank to correctly represent layered overpasses, bridges, and tunnels.

The landuse_kind value is calculated by intercutting roads with the landuse layer to determine if a road segment is over a park, hospital, university or other landuse feature. Use this property to modify the visual appearance of roads over these features. For instance, light gray minor roads look great in general, but aren't legible over most landuse colors unless they are darkened.

To improve performance, some road segments are merged at low and mid zooms. To facilitate this, certain properties are dropped at those zooms. Examples include is_bridge and is_tunnel, name, network, oneway, and ref. The exact zoom varies by feature class.

Road Properties (common)

The following properties are used to define a road.

  • name - Generally the name the locals call the feature, in the local language script.
  • kind - Roads can be one of the options listed below.
  • kind_detail - See the kind_detail values list below.
  • landuse_kind - For more information, see the description above.
  • sort_rank - This property contains a suggestion in which order to render features. The value is an integer where smaller numbers suggest that features should be "behind" features with larger numbers. At zoom 14 and higher, the sort rank is adjusted to realistically model bridge and tunnel. For example, sort_rank = 377 for is_bridge at zoom 13 becomes sort_rank = 427 at zoom 14.
  • min_zoom - This property indicates a suggested minimum zoom at which the road should become visible.
  • ref - A commonly used reference for roads - for example, "I 90" for Interstate 90. To use with shields, see the network and shield_text properties.
  • network - This property is useful for shields and road selections - for example, US:I for the United States Interstate network. It contains only road network types. For more information, see a full list of possible road network values.
  • shield_text - This property contains the text to display on a shield. For example, I 90 would have a network of US:I and a shield_text of 90. The ref value, I 90, is less useful for shield display without further processing. For some roads, this property can include non-numeric characters - for example, the M1 motorway in the UK has a shield_text value of M1 rather than just 1.
  • all_shield_texts - All the shield texts of which this road is a part. This is given as semicolon-separated shield_text values. See shield_text above.
  • all_networks - All the networks of which this road is a part. This is given as semicolon-separated network values. See network above.
  • all_route_types - All the route types of which this road is a part. This is given as semicolon-separated numeric codes used for shield styling depending on the country.
  • hgv_restriction - This property indicates limitations to heavy goods vehicle truck access. See the hgv_restriction values list below. Always available only on points.

Road Properties (common-optional)

The following properties are used to define additional information about a road.

  • is_bridge - true if the road is part of a bridge. This property is not present if the road is not part of a bridge.
  • is_link - true if the road is part of a highway link or ramp. This property is not present if the road is not part of a highway link or ramp. Attributes with is_link = true are part of the premium content.
  • is_tunnel - true if the road is part of a tunnel. This property is not present if the road is not part of a tunnel.
  • is_present_in_landuse - true if the road has a detailed polygonal representation by the landuse kinds expressway, urban_expressway, national_road, major_road, and other_road, or formed as an area not covered by the landuse kind block for minor roads. This property is present only within the core layer parameter with limited coverage for Japan at zoom 14. It allows filtering of road centerlines while showing detailed road geometries from the landuse data.
  • hgv - This property indicates general truck heavy goods vehicle truck access. Available only on lines. Values include: no.

    Note

    If the hgv property has the value no, then the road has no hgv_restriction and hgv_restriction_shield_text properties. In other cases, the road can have the hgv_restriction and hgv_restriction_shield_text properties.

  • hgv_restriction - This optional property indicates limitations to heavy goods vehicle truck access. Available on both points and lines. See the hgv_restriction values list below. See also hgv_restriction_shield_text.

  • hgv_restriction_shield_text - This optional property is always paired with hgv_restriction and indicates the value of limitation to heavy goods vehicle truck access. Because the units are different per restriction, an abbreviation is provided next to the value, for example, 5.1m or 16'9" (US), 4t or 4.4 T (US). Such values are specified with one decimal precision, but the value of 5.0m is given as 5m. See the hgv_restriction_shield_text values list below.
  • fclass - This property indicates a functional class numeric value for roads with kind_detail = motorway and kind_detail = motorway_link. For more information, see Road Transportation fclass Values.
  • under_construction - true. This property indicates that the road is under construction and may not be usable by some or all types of traffic. The property is not present if the road is not under construction.
  • surface - unpaved if the road is unpaved. This property is not present if the road is paved.
  • oneway - An optional property that indicates if traffic is one-way and travels in the same direction as the linestring. This property can only have the following values: yes.
  • 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.

Road Transportation kind Values

  • aerialway - line
  • ferry - line
  • hgv_restriction - point, indicates limitations to heavy goods vehicle truck access
  • highway - line
  • major_road - line
  • minor_road - line
  • path - line
  • rail - line

Road Transportation kind_detail Values

  • cable_car - for aerialway kind
  • gondola - for aerialway kind
  • ferry - for ferry kind
  • motorway - for highway kind
  • trunk - for highway kind
  • primary - for major_road kind
  • secondary - for major_road kind
  • tertiary - for major_road kind
  • residential - for minor_road kind
  • service - for minor_road kind
  • unclassified - for minor_road kind
  • pedestrian - for path kind
  • footway - for path kind
  • rail - for rail kind

Road Transportation kind_detail Values for Certain Areas in core

The following list of kind_detail values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile Service, see Layer Parameter.

Below are these kind_detail values within the core layer parameter for Japan:

  • light_rail - for rail kind
  • subway - for rail kind
  • speed_rail - for high-speed railroads with rail kind
  • private_rail - for privately owned railroads with rail kind
  • state_rail - for state-owned railroads with rail kind
  • monorail - for monorails with rail kind

Road Transportation hgv_restriction Values

For the hgv_restriction property indicates general restrictions to heavy goods vehicle truck access, the values include:

  • weight - weight restriction
  • height - height restriction
  • length - length restriction
  • width - width restriction
  • wpa - weight per axle restriction
  • axles - number of axles restriction
  • kpra - kingpin to rear axle length restriction
  • hazmat - restriction for vehicles that carry hazardous materials
  • trailers - trailers restriction
  • other - other restriction
  • multiple - if more than one restriction (represented by points along the line, where every point indicates specific restriction that applies to this road)

Road Transportation hgv_restriction_shield_text Values

For weight restriction:

  • weight value, for example, 4t or 4.4 T (US)

For height, length, width, and kpra restrictions:

  • height, length, or width value, for example, 5.1m or 16'9" (US)

For wpa restriction:

  • weight value, for example, 1.8t or 2 T (US)
  • text value, where N is weight value:
    • Single axle N
    • Tandem axle N

For axles restriction:

  • Two or more axles
  • Three or more axles
  • Four or more axles
  • Five or more axles
  • Six or more axles

For hazmat restriction:

  • Hazardous material type unknown
  • Unspecified hazardous material type
  • Explosives
  • Gas
  • Flammable
  • Flammable solid combustible
  • Organic
  • Poison
  • Radioactive
  • Corrosive
  • Other
  • Any hazardous material
  • Poisonous inhalation hazard
  • Goods harmful for water
  • Explosive and flammable
  • Tunnel category b
  • Tunnel category b1000c
  • Tunnel category b d
  • Tunnel category b e
  • Tunnel category c
  • Tunnel category c5000d
  • Tunnel category c d
  • Tunnel category c e
  • Tunnel category d
  • Tunnel category d e
  • Tunnel category e

For trailers restriction:

  • One or more
  • Two or more
  • Three or more
  • Semi or tractor with trailers

For other and multiple restrictions, hgv_restriction_shield_text is omitted.

Road Transportation fclass Values

Roads in the HERE Vector Tile Service are traditionally categorized into so-called functional classes, which do not match one-to-one Tilezen's roads categorization. The mapping from one to the other are as follows.

Functional Class Tilezen Road properties
N kind is highway and kind_detail is motorway and fclass is N
1 kind is highway and kind_detail is trunk
1 kind is highway, kind_detail is motorway_link, is_link is true and any fclass
2 kind is major_road and kind_detail is primary
3 kind is major_road and kind_detail is secondary
4 kind is major_road and kind_detail is tertiary
5 kind is minor_road and kind_detail is (residential or service)
5 kind is path and kind_detail is (footway or pedestrian)

Road Transportation fclass Values for Certain Areas in core

The following list of fclass values is only applicable for some regions of the world within the core layer parameter. For more information about the layer parameters available in the HERE Vector Tile Service, see Layer Parameter.

Below are these fclass values within the core layer parameter for Japan:

Functional Class Tilezen Road properties
1 kind is highway, and kind_detail is motorway
2 kind is highway and kind_detail is motorway
3 kind is highway and kind_detail is motorway
3 kind is major_road and kind_detail is primary
4 kind is major_road and kind_detail is secondary
5 kind is major_road and kind_detail is secondary
6 kind is major_road and kind_detail is tertiary
7 kind is major_road and kind_detail is tertiary
8 kind is minor_road and kind_detail is resedential
8 kind is path and kind_detail is pedestrian
9 kind is minor and kind_detail is (resedential or service)
10 kind is minor_road and kind_detail is (resedential or service)
10 kind is path and kind_detail is (footway or pedestrian)
11 kind is minor_road and kind_detail is (resedential or service)
11 kind is path and kind_detail is (footway or pedestrian)

Road Labels (Optional)

This is an optional layer, and its content is defined as follows.

  • Layer name: road_labels
  • Geometry types: line

This layer contains deduplicated labeling attributes (name, ref, network, shield_text) and simplified label placement geometry for all kinds of transportation, including but not limited to highways, major roads, minor roads, paths and ferries, which are present in the roads layer.

In the roads layer, each road segment contains labeling attributes, which could be the same (and there are a lot of them) for consecutive road segments. To remove such duplicates and avoid post processing on the client side, the road_labels layer stores already merged and simplified consecutive road segments with the same name properties. However, you still can decide which layer (roads or road_labels) best suits your special needs as a source of labeling attributes.

Road Label Properties (common)

  • name - Generally the name the locals call the feature, in the local language script.
  • ref - A commonly used reference for roads - for example, "I 90" for Interstate 90. To use with shields, see the network and shield_text properties.
  • network - This property is useful for shields and road selections - for example, US:I for the United States Interstate network. It contains only road network types. For more information, see a full list of possible road network values.
  • shield_text - This property contains the text to display on a shield. For example, I 90 would have a network of US:I and a shield_text of 90. The ref value, I 90, is less useful for shield display without further processing. For some roads, this property can include non-numeric characters - for example, the M1 motorway in the UK has a shield_text value of M1, rather than just 1.
  • all_route_types - All the route types of which this road is a part. This is given as semicolon-separated numeric codes used for shield styling depending on the country.

Transit

The layer content is defined as follows.

  • Layer name: transit
  • Geometry types: polygon

This layer contains transit polygons for station platforms.

Transit Properties (common)

The following properties are used to define a transit feature.

  • id - This is an ID used internally within HERE.
  • kind - This can be one of the options listed below.
  • sort_rank - This property contains a suggestion in which order to render features. The value is an integer where smaller numbers suggest that features should be "behind" features with larger numbers.

Transit kind and sort_rank Values for Certain Areas in core

The following list of kind and sort_rank values is only applicable for some regions of the world within the core layer parameter. For more information about the different layers available in the HERE Vector Tile Service, see Layer Parameter.

Below are these kind and the corresponding sort_rank values within the core layer parameter for Japan:

  • railway_station_platform - 385
  • subway_station_platform - 385

Water

The following figure illustrates an example of a water feature rendered from the data.

View of the Mexico Gulf
Figure 8. View of the Mexico Gulf

The layer content is defined as follows.

  • Layer name: water
  • Geometry types: point, line, polygon

Water polygon geometries represent oceans, riverbanks, and lakes.

This layer also includes water line geometries for river and stream centerlines and label position point geometries for labeling polygons deduplicated across tile boundaries.

Water Properties (common)

The following properties are used to define a water feature.

  • name - This property contains the name of the geometry type and includes localized name variants.
  • kind - This can be one of the options listed below.
  • sort_rank - This property contains a suggestion in which order to render features. The value is an integer where smaller numbers suggest that features should be "behind" features with larger numbers.
  • min_zoom - This property indicates a suggested minimum zoom at which the feature should become visible.
  • intermittent - true. This property marks features that sometimes run dry or disappear seasonally.

Water Properties (common-optional)

  • id - This is an ID used internally within HERE. Available only for line and point geometries.

Water kind Values

The water kind values are as follows:

  • bay - point
  • canal - line
  • fjord - point
  • lake - point
  • ocean - point
  • sea - point
  • strait - point
  • stream_intermittent - line
  • river - line or point
  • water - polygon

All polygons correspond to water while points and lines are used for labeling.

results matching ""

    No results matching ""