Annotations

Create 3D markers and notes directly in the model.

Overview

Annotations are spatial markers with text that are placed at specific positions in 3D space.

Uses:

• Mark defects
• Ask questions to planners
• Document change requests
• Record inspection points

Creating an Annotation

1. Click on → "Annotation Mode" in the toolbar
2. Click or tap on the desired position in the model
3. Enter a Title and optionally a Description
4. Optional: Upload an image (file upload)
5. Select a category:
   • Info
   • Warning
   • Error
6. Click "Save"

The annotation appears as a marker in 3D space.

Default View

Annotations are initially displayed only as markers. Click on a marker to view the full text.

Viewing Annotations

Markers

In the viewer, annotations are displayed as colored markers:

• Blue - Information
• Yellow - Warning
• Red - Error/Defect

Click

Click on a marker to:

• Read the full text
• Edit the annotation

Fly to Annotation

Use the zoom button next to each annotation in the annotation list:

1. Open the Annotation List via your avatar menu
2. Click on the crosshairs icon next to the desired annotation
3. The camera smoothly moves to the position and zooms to 10 meters distance
4. The annotation text is automatically displayed

Viewing Attached Images

If an image is attached to an annotation:

• The image icon appears in the annotation header
• Click on the icon to view the attached image
• Useful for photos of defects or detail views

Annotation List

All annotations are displayed in a list:

1. Click on the list icon in the toolbar
2. The list shows all annotations with:
   • Text (truncated)
   • Category
   • Creator
   • Date

Navigating the List

Click on an entry to jump to the annotation.

Editing an Annotation

Method 1: By Click

1. Click on the annotation in the viewer
2. Click "Edit"
3. Change text or category
4. "Save"

Method 2: By Right-Click (Context Menu)

1. Right-click on the annotation in the viewer
2. Select "Edit" from the context menu
3. Change text or category
4. "Save"

Deleting an Annotation

Method 1: By Click

1. Click on the annotation
2. Click "Delete"
3. Confirm

Method 2: By Right-Click (Context Menu)

1. Right-click on the annotation in the viewer
2. Select "Delete" from the context menu
3. Confirm

Permission

Only the creator and admins can delete annotations.

Delete All Annotations (Admin)

Admins can remove all annotations from a project:

1. Open the Admin Area
2. Select "Annotations"
3. Select the project
4. Click "Delete All"

Import Geodata

Import annotations from geodata files:

Supported Formats

• GeoJSON (.geojson, .json) - Standard geodata format
• Shapefile (.shp, .zip) - ESRI Shapefile format
• GeoPackage (.gpkg) - OGC GeoPackage
• KML/KMZ (.kml, .kmz) - Google Earth format
• GPX (.gpx) - GPS Exchange Format
• GML (.gml) - Geography Markup Language

Import Workflow

1. Click on → Import Geodata
2. Select File:
   • Click "Browse" and select the file
   • Or: Drag the file directly into the dialog (drag & drop)
3. The system analyzes the file and shows the number of features found
4. Coordinate Transformation (optional):
   • Enable "Transform Coordinates" if your data uses a different coordinate system
   • Select the target EPSG (e.g., EPSG:25832 for UTM32, EPSG:4326 for GPS)
5. Click "Next"
6. Configure Field Mapping:
   • Title Field: Select the field for the annotation title (e.g., "name", "description")
   • Description Field: Optional - field for additional description
   • Category: Select the annotation category for all imported points:
     • Information - General notes
     • Warning - Anomalies
     • Error - Defects and issues
   • Z-Coordinate: Select the source for elevation:
     • Use from Geometry - Uses Z value from the geodata file (if available)
     • From Property - Uses a field from the attributes (e.g., "height", "elevation")
     • Default Value - Fixed Z value for all points
7. Check Preview:
   • View a table with the first 50 points
   • Double-click values to edit them
   • Check X, Y, Z coordinates
8. Click "Import"

Coordinate Systems (EPSG)

Supported coordinate systems for transformation during geodata import:

EPSG	Name	Usage
25832	ETRS89 / UTM zone 32N	Germany (Standard)
4647	ETRS89 / UTM zone 32N (zE-N)	Germany (Surveying)
8395	ETRS89 / Gauss-Kruger CM 9E	Hamburg, Northern Germany
4326	WGS 84	GPS coordinates (Lat/Lon)
3857	Web Mercator	Online maps (Google Maps, OSM)
31467	DHDN / 3-degree Gauss-Kruger zone 3	Legacy German surveying

Automatic Detection

The system attempts to automatically detect the coordinate system from the geodata file. For GeoJSON and GeoPackage, this is usually included.

Field Name Recognition

The system automatically recognizes common field names like "name", "Name", "description", "desc" and suggests these as mappings.

Shapefile Import

Shapefiles must be uploaded as a ZIP file containing at least:

• .shp - Geometry
• .shx - Index
• .dbf - Attributes
• .prj - Coordinate system (recommended)

Shapefile Preparation

Pack all shapefile components (.shp, .shx, .dbf, .prj) into a ZIP file before uploading.

Inline Editing

In the preview table you can adjust values:

• Double-click on title or description → Edit text
• Double-click on Z value → Adjust elevation
• Enter → Save change
• Esc → Discard change

Changed values are used during import.

Export

Export annotations as:

• JSON - For data backup
• PDF - With screenshots of positions

Tips

Collaboration

Annotations are synchronized in real-time. Other users see new annotations immediately.

Link to Element

Click on an element while creating an annotation to link it to that element. The annotation will then "move" with the element.

See Also

• Real-time Collaboration - Synchronize annotations
• 3D Viewer - Navigation and element selection
• Mobile & Touch - Annotations on mobile devices