Skip to main content

Geometry attribute

Store location and geometry coordinates​

A Geometry attribute can store geometry coordinates in GeoJSON format.

While all designs/interfaces inherit a standard Geometry attribute via the Items interface, you can add additional Geometry attributes to hold other location information.

info

To configure the standard Geometry attribute, see Edit the design or interface.

Configuration​

When adding or editing a Geometry attribute on a design/interface, you can configure the following properties. These determine how the attribute will behave when users populate its value on corresponding items.

  • Code (read-only) - the attribute's Global Unique Code (Guc) identifier.
  • Name * - enter a distinct name that clearly identifies the attribute.
  • Description - describe what the attribute represents and how it's intended to be used. This helps users and AI agents to understand its purpose.

  • Required - if enabled, the attribute must be populated before an item can be saved. It can't be left blank!

  • Read-only - if enabled, the attribute can only be populated when creating items. It can't be edited afterwards!

  • Unique - if enabled, the attribute only accepts values that aren't already stored in other items of the design/interface.

  • Allows * - the attribute will only accept the selected geometry types.
  • Default value - the attribute is automatically populated with this value. It can usually be changed before saving, unless the attribute is also Read-only or excluded from an item form.

  • Tags - use the Tag Manager to assign custom tags or a relevant system tag.

    Available system tags

    Treat the attribute as:

    • GeometryTrail - a line of points that may be extended over time, rather than a fixed line, e.g. tracking location history in the Vehicles module. The tag doesn't do this automatically. It can be done via a workflow, import, or similar.

    • RequiredOnTaskStatus[Completed/Cancelled] - only relevant if the design/interface implements the Tasks interface. The attribute becomes required when a task's status changes to Completed/Cancelled.

    • ActionParameter[Dynamic] - for internal use only. Marks the attribute as a configurable parameter on a workflow action.

  • AQS agent enabled - if disabled, the attribute is excluded from AI agent queries.

Populate the attribute on items​

When creating or editing an item, select the attribute to open the Geometry Editor. Draw point, line or polygon geometry using the available tools or enter GeoJSON code.

A GeoJson attribute field
Drawing GeoJSON in the Geometry Editor
info

To populate the standard Geometry attribute on an item, use the Map section.