Data Format API Maps

Maps Documentation

This is the latest version from 2024-03.



Supported map viewers

MapLibre



	

Run

Code

  1. 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.
  2. Replace {ONEGEO_MAPS_KEY} with your ONEGEO Maps key and you are ready to go.

OSMBuildings



	

Run

Code

  1. Replace {ONEGEO_MAPS_KEY} with your ONEGEO Maps key and you are ready to go.

Mapbox GL



	

Run

Code

  1. 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 {MAPBOX_ACCESS_TOKEN} in the example above.
  2. 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.
  3. Replace {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.

Want to know more?
Get in touch.