2D Vector Task

With the 2D Vector Task, the creation of 3D objects out of 2D features, like points, lines and polygons is enabled. The task will create features / objects with absolute heights based on the height information from features or taken from terrain. The task can be used to create, for example, LOD 1 buildings from footprints or walls by extruding lines.

This task will create absolute height features, which means that the height of the created features will not be relative to the terrain but will be based on the height information provided in the input data or taken from the terrain. Therefore, it is mandatory that the input data contains height information for the features. If no height information is available, the created features will be flat and located at Z=0. Features will NOT be draped on the terrain surface. For polygons, the center point will be used to determine the height of the entire feature. This means that if a polygon covers an area with varying terrain heights, the created feature will have a uniform height based on the terrain height at the center point of the polygon. For lines, the height will be determined based on the start point of the line. This means that if a line covers an area with varying terrain heights, the created feature will have a uniform height based on the terrain height at the start point of the line.

Step 1

Option Description

Task Name

Name of the task.

Create or overwrite Datasource

Select whether to create a new datasource or overwrite an existing one

Datasource Name

If an existing data source is to be overwritten, select the source here.

Step 2 - Input data

General settings

Option Description

Directory

a path to the directory containing the 2D vector data should be provided here. A valid path could be \\fs01\vcs\00_xxx\xxx_project\Data\GeoJson

File

Option to specify a single file instead of a directory. A valid name could be data.geojson or data.shp or data.json. Alternatively, a wildcard can be used to specify multiple files, e.g. *.geojson or *.shp or *.json. The file(s) must be located in the directory specified in the previous option. The file(s) can be in GeoJSON or Shapefile. By using the wildcard option, you can also specify if "subdirectories" (by enabling the option include subdirectories) should be included in the search for files. For example, if you specify the file option as *\.geojson, all GeoJSON files in the specified directory and all its subdirectories will be included.

Default color

The resulting color for the 2D vector features can be specified here, either by choosing a color from color picker or by typing in a HEX string, rgb() or rgba() string.

Vector properties settings

Option Description

Object ID property

Here the name of the property in the input data can be specified that contains the unique identifier for each feature. This property will be used to assign a unique ID to each created 3D object. If this option is not specified, a unique ID will be generated automatically for each feature.

Extrude Points

If enabled, point features will be extruded to 3D objects with a specified height. The height can be defined in the extrusion property (see Extrusion Property option) or set to a default value (see Fallback Extrusion Height).

Extrude Lines

If enabled, line features will be extruded to 3D objects with a specified height. The height can be defined in the extrusion property (see Extrusion Property option) or set to a default value (see Fallback Extrusion Height).

Extrude Polygons

If enabled, polygon features will be extruded to 3D objects with a specified height. The height can be defined in the extrusion property (see Extrusion Property option) or set to a default value (see Fallback Extrusion Height).

Extrusion Property

Here the name of the property in the input data can be specified that contains the height information for extrusion. This property will be used to determine the height of the created 3D objects. If this option is not specified, the Fallback Extrusion Height will be used for all features.

Fallback Extrusion Height

If the extrusion property is not specified or if a feature does not have a value for the extrusion property, this default height will be used for extrusion. The height will be specified in meters.

Spatial reference settings

Option Description

Coordinate Reference System

The CRS of the input data can be specified here by choosing one of the options:

Option Description

Same as source

will take the CRS from file (default is EPSG:4326), if not specified in the file, it will be assumed to be EPSG:4326

Override with SRS code

will override the CRS from the file with the specified EPSG, ADV, OGC or ESRI SRS code (e.g. EPSG:25832).

Override with WKT

will override the CRS from the file with the specified WKT string.

Height Mode

The height mode for the created 3D objects can be specified here. The following options are available:

Option Description

Absolute

The height of the created 3D objects will be based on the height information provided in the input data. The created features will not be draped on the terrain surface. This is the default option.

Ellipsoid

The height of the created 3D objects will be based on the ellipsoid at the location of each feature. This means that the height of the created features will be determined by adding the height information from the input data to the ellipsoid height at the location of each feature. The created features will be not draped on the terrain surface.

Terrain

The height of the created 3D objects will be based on the terrain surface at the location of each feature. This means that the height of the created features will be determined by adding the height information from the input data to the terrain height at the location of each feature. The created features will be draped on the terrain surface. Please choose a terrain datasource that is already configured in the project (see Datasources) to ensure that the height information is correctly applied to the created features.

Offset

The offset value can be specified here to adjust the height of the created 3D objects. The offset will be added to the height determined by the selected height mode. The height will be specified in meters.

Spatial filter settings

Option Description

Bounding Box Filter

If enabled, only features that intersect with the specified bounding box will be processed. The bounding box can be defined by specifying the minimum and maximum coordinates in the X and Y directions (e.g. minX,minY,maxX,maxY).

Bounding Box

the coordinates for the bounding box filter should be specified here in the format minX,minY,maxX,maxY (e.g. 7.0,50.0,8.0,51.0) or by clicking the Static and drawing the bounding box on the map.

Step 3 - Task settings

Tiling settings

Option Description

Tile level

Here the tile level for the output can be set. Depending on the size of the features you should adjust the level. See the below table for level explanation Tile levels acc. to Openstreemap.org:

Level # Tiles Tile width (° of longitudes) m / pixel (on Equator) ~ Scale (on screen) Examples of areas to represent

0

1

360

156 543

1:500 million

whole world

1

4

180

78 272

1:250 million

2

16

90

39 136

1:150 million

subcontinental area

3

64

45

19 568

1:70 million

largest country

4

256

22.5

9 784

1:35 million

5

1 024

11.25

4 892

1:15 million

large African country

6

4 096

5.625

2 446

1:10 million

large European country

7

16 384

2.813

1 223

1:4 million

small country, US state

8

65 536

1.406

611.496

1:2 million

9

262 144

0.703

305.748

1:1 million

wide area, large metropolitan area

10

1 048 576

0.352

152.874

1:500,000

metropolitan area

11

4 194 304

0.176

76.437

1:250,000

city

12

16 777 216

0.088

38.219

1:150,000

town, or city district

13

67 108 864

0.044

19.109

1:70,000

village, or suburb

14

268 435 456

0.022

9.555

1:35,000

15

1 073 741 824

0.011

4.777

1:15,000

small road

16

4 294 967 296

0.0055

2.389

1:8,000

street

17

17 179 869 184

0.0027

1.194

1:4,000

block, park, addresses

18

68 719 476 736

0.0014

0.597

1:2,000

some buildings, trees

19

274 877 906 944

0.00069

0.299

1:1,000

local highway and crossing details

20

1 099 511 627 776

0.00034

0.149

1:500

A mid-sized building

Output settings

Option Description

Double Sided Rendering

Choose this option, if face normals are not correctly defined in the input data and you want the created features to be visible from all sides. Enabling this option will result in a slightly higher data volume and may increase rendering time, but it ensures that the features are visible regardless of the viewing angle.

Post Processing

Choose here from None (default), or Google Draco Transcoder to further compress the output data. If you choose Google Draco Transcoder, the created 3D objects will be compressed using the Draco algorithm, which can significantly reduce the data size and improve rendering performance, especially for large datasets. However, please note that enabling this option may increase the processing time of the task, as the compression process can be computationally intensive.

Step 4 - Task schedule

Option Description

Start Job as soon as possible

Start the job immediately.

Start Job once at given time

Schedule job for a future time.

Repeat Job

Automatic periodic execution of the job.

Publish Job after Completion

Once conversion is successful, the datasource is published automatically.