MAPS Documentation
Vector Tiles for 3D map viewers
Supported map viewers
MapLibre
- In the example above, you need to define your map style by replacing {MAP_STYLE} with one our predefined sets:
dusk, noon, urban
You may also modify our map styles manually or define your very own by using an editor like Maputnik. - Replace {YOUR_ONEGEO_MAPS_KEY} with your ONEGEO Maps key and you are ready to go.
Mapbox GL
- In order to use the latest Mapbox GL viewer you'll need a Mapbox account. You may also stay with their map service entirely but you would miss our superior building layer. So, go for their access token and replace {YOUR_MAPBOX_ACCESS_TOKEN} in the example above.
- Define your map style by replacing {MAP_STYLE} with one our predefined sets:
dusk, noon, urban
You may also modify our map styles manually or define your very own by using an editor like Maputnik. - Replace {YOUR_ONEGEO_MAPS_KEY} with your ONEGEO Maps key and you are ready to go.
Available map layers
aerodrome_label
This layer contains aerodrome labels as points.
aeroway
Airport buildings are contained in the building layer but all other airport related polygons can be found in the aeroway layer.
boundary
Contains administrative boundaries as linestrings.
building
This layer contains all our building data.
From zoom level 0 to 10 visualized as points (small hexagonal polygons),
zoom level 11 to 13 as flat polygons and
from zoom level 14 as extruded features with all attributes.
| Attribute | Type | Description |
|---|---|---|
| id | String | Building Identifier. It can occur multiple times in order to relate building parts. |
| name | String | building name i.e. Chrysler Building |
| type | String | type of building i.e. commerce, residence |
| height | Float | total building height - in meters |
| minHeight | Float | height at which a building part starts vertically (floating) - in meters |
| levels | Float | total building levels |
| minLevel | Float | levels at which a building part starts vertically (floating) |
| color | String | dominant color of building facade named colors, rgb() or #hex values |
| material | String | dominant material name i.e. concrete, glass |
| shape | String | building shape if unusual i.e. sphere, pyramid |
| roofShape | String | roof shape i.e. skillion, flat, dome |
| roofHeight | Float | roof height (included in total height) - in meters |
| roofLevels | Float | roof levels (add to buildings levels) |
| roofColor | String | dominant roof color named colors, rgb() or #hex values |
| roofMaterial | String | dominant roof material name i.e. tiles |
| roofDirection | Float | direction where a roof is facing - clockwise in degrees from north |
landcover
Landcover is used to describe the physical material at the surface of the earth.
landuse
Landuse is used to describe use of land by humans.
park
The park layer contains parks.
place
The place layer consists out of countries, states, cities and islands.
poi
Points of interests containing a of a variety of attributes. Mostly contains amenities, sport, shop and tourist POIs.
transportation
Transportation layer contains roads, railways, aerial ways, and shipping lines. It contains all roads from motorways to primary, secondary and tertiary roads to residential roads and foot paths.
transportation_name
This is the layer for labelling the highways.
water
Water polygons representing oceans and lakes. The polygons are split into many smaller polygons to improve rendering performance. This however can lead to less rendering options in clients since these boundaries show up. So you might not be able to use border styling for ocean water features.
water_name
Lake center lines for labelling lake bodies.
waterway
Linestrings without a name or which are too short are filtered out at low zoom levels. Description.