Data Format API Maps

Maps Documentation

This is the latest version from 2024-03.



Supported map viewers

MapLibre



	

		

			
			
Run

		

		

			
			
Code

		

		

			
				
			
			
				
Download

			
		

	


	
    
	
  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. 

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



	
OSMBuildings


	

	


	

		

			
			
Run

		

		

			
			
Code

		

		

			
				
			
			
				
Download

			
		

	


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



	
Mapbox GL


	

	


	

		

			
			
Run

		

		

			
			
Code

		

		

			
				
			
			
				
Download

			
		

	



	
    
		
  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. 

	
  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. 

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




	


	
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.

			


			

				
			


			

				Contact us