Vectorine Vector Tile Data Schema

Purpose of this Document

This document will help you work with vector tiles provided by Vectorine. It lists the layers and available attributes, which can support you designing a map style that suits your needs.

The contents of this document are authoritative, other attributes that may be included in the tile data, but are not listed here, are not part of any stability guarantee. Especially feature selection and ranking can be adjusted at any time.

Usage

Vector tiles contain geographical features which can be rendered into a graphical form using an appropriate software. Depending on your specific use case you can utilize one of the following:

For legacy projects you can also use Mapbox GL, but please note that releases starting version 2.0 are not open source and subject to their terms and conditions. Maplibre GL is a compatible drop-in replacement.

File Format

The tiles are compliant with MVT version 2.1. They can be requested with gzip compression using the “Accept-Encoding” HTTP header for best performance.

Layers

The vector tiles contain layers which help you customize the look of your maps. E.g. if you prefer not to display data in a certain category, you can skip the layer in your style definition. You can also change the order of display to emphasize certain feature types above others.

Geographical elements can contain attributes depending on their layer. Those attributes are listed in their respective layer documentation, see below.

Not every data type or element is available on every layer. Please refer to the zoom level of the respective layer for more information.

All objects come with a geometry of the specified type and the ID attribute. The ID is not guaranteed to be stable.

Addresses

Layer Name/Identifieraddresses
Geographical TypePoint
Zoom Level14+
DescriptionHouse numbers (or house names for some regions)

Properties

KeyValuesZoom Level
nameFree form value, e.g. "2A"14+

Boundaries

Layer Name/Identifierboundaries
Geographical TypeLine String
Zoom Level1+
DescriptionAdministrative and political boundaries. Larger scale maps contain most important divisions, with increasing detail with decreasing scale.

Properties

KeyValuesZoom Level
nameName of the boundary, e.g. "Germany"1+

Buildings

Layer Name/Identifierbuildings
Geographical TypePolygon
Zoom Level14+
DescriptionBuilding footprints and parts

Properties

KeyValuesZoom Level
heightNumeric value in meters14+
layerRelative numeric value14+

Landcover/Landusage

Layer Name/Identifierland
Geographical TypePolygon
Zoom Level12+
DescriptionCultural or physical land usage

Properties

KeyValuesZoom Level
kindforest, residential, farmland, grass, meadow, orchard, farmyard, industrial, reservior, vineyard, cemetery, military, wood, grassland, bare_rock, scree, shingle, swamp, bog, string_bog, wet_meadow, marsh, danger_area12+

Oceans

Layer Name/Identifierocean
Geographical TypePolygon
Zoom Level1+
DescriptionCovered area by oceans

Objects on this layer do not have any attributes.

Places

Layer Name/Identifierplaces
Geographical TypePoint
Zoom Level3+
DescriptionLabel positions for cultural and political divisions, e.g. country, city labels

Properties

KeyValuesZoom Level
kindcountry, city, island3+
town6+
suburb, village10+
hamlet, suburb, locality, isolated_dwelling, farm13+

Points of Interest

Layer Name/Identifierpoi
Geographical TypePoint
Zoom Level12+
DescriptionSignificant points of interest, e.g. schools, universities, places of worship or mountain peaks

Properties

KeyValuesZoom Level
kindhospital, school, college, university, place_of_worship, kindergarden, peak12+
nameFree form, e.g. "University of Cologne"

Public Transport

Layer Name/Identifierpublic_transport
Geographical TypePoint
Zoom Level10+
DescriptionNodes of public transport, e.g. railway stations, bus stops, airports

Properties

KeyValuesZoom Level
nameFree form, e.g. "Kourou Central Station"8+
kindairport8+
station, halt10+

Roads

Layer Name/Identifierroads
Geographical TypeLine String
Zoom Level2+
DescriptionStreets, roads and paths for motorized and unmotorized transportation

Properties

KeyValuesZoom Level
kindmajor2-7
motorway, motorway_link, trunk, trunk_link, primary, primary_link, secondary, secondary_link, tertiary, tertiary_link, road, residential8+
rail, light_rail13+
nameFree form, e.g. "Dorfstraße"12+

Water

Layer Name/Identifierwater
Geographical TypePolygon
Zoom Level3+
DescriptionWater covered areas, e.g. rivers and lakes

Properties

KeyValuesZoom Level
nameFree form, e.g. "Sun Moon Lake"2+

Additional Data

If you have a use case for data that is not covered by the above layers, please contact us.

Integration Guide

Much of the data is based on OpenStreetMap source material, therefore attributing OpenStreetMap is mandatory. Please place “© OpenStreetMap contributors” in the corner of your map and link to https://www.openstreetmap.org/copyright.