Location

Category: Field

Version: 1.0

Last Updated: April 15, 2026

Author: Any2Info


Description

The Location field is a form field used to capture and store a geographical location.

In addition to storing the current location, the field also supports displaying a target location, enabling comparison or guidance scenarios within a form.

This field is specifically designed for use within forms and works with data of type Location.

Configuration Options

Setting
Required
Description

Target

No

Maps to a header of type Location. Defines a target location that can be displayed alongside the current location.


Data Format

The Location field uses the following format: latitude;longitude;precision;altitude;altitudePrecision

  • latitude (required) → Latitude coordinate

  • longitude (required) → Longitude coordinate

  • precision (optional) → Accuracy of the location

  • altitude (optional) → Height above sea level

  • altitudePrecision (optional) → Accuracy of the altitude

At minimum, latitude and longitude must be provided. Additional values are optional.

This format must match the standard used across dataclips. :contentReference[oaicite:0]{index=0}


Usage

Use the Location field in forms where geographical input or reference is required.

Typical use cases include:

  • Capturing a user's current location

  • Comparing a current location to a predefined target

  • Supporting navigation or location-based workflows


Events

Event
Description

On Value Changed

Triggered whenever the current location value is updated.


Mappings

Mapping
Description

Target

Links the field to a Location-type header to display a target location.


Tips & Best Practices

  • Always ensure the mapped Target header is of type Location.

  • Provide at least latitude and longitude to avoid invalid data.

  • Use the target mapping when guiding users toward a specific location.


Changelog

Version
Date
Change

1.0

April 15, 2026

Initial documentation version added.

Last updated

Was this helpful?