Docs & Tutorials

Radio Button Field

Location Field

The Location field allows users to capture geographic coordinates directly within a form. It supports two modes of input: automatic GPS/browser detection (current location) and manual map selection (choose any point on the embedded Google Map).

Prerequisite

To enable the Location field, you must configure a Google Maps API key in your NileDesk Organization Settings. The field will remain inactive until a valid API key is provided.

Properties

  • Field Title / Name — The label displayed on the form.
  • Field ID — Unique identifier for use in expressions and references.
  • Helper Text — Guidance or hints shown beneath the field.

Field Settings

The Location field also supports all standard Basic Field Settings such as Title, ID, Required, and Visibility.

Location Input Options

  • Current Location — Automatically detects the user’s location using browser or device GPS.
  • Custom Location — Allows users to select any point manually on the map.
  • Both Options — Provides flexibility to either auto-detect or select manually.

Permissions

When using Current Location, browsers or mobile devices prompt the user for location access. If denied, automatic detection is unavailable, but Custom Location remains usable (if enabled).

How Location Is Stored

The Location field stores a snapshot of the captured point, typically including:

  • Latitude (decimal)
  • Longitude (decimal)
  • Formatted Address (if reverse geocoding is enabled)
  • Timestamp when the location was recorded

Example stored value: {"lat": 24.8615, "lng": 67.0099, "address": "Karachi, Pakistan", "capturedAt": "2025-09-17T14:30:00Z"}

Behavior & Expressions

Like other fields, Location supports conditional expressions to control:

  • Visibility — Show or hide the field based on conditions.
  • Enable/Disable — Make the field interactive or read-only.
  • Mandatory — Require location capture conditionally.

Example: IsRemoteRequest == true → require location capture.

Filters & Use Cases

Filters are generally not applicable to single-point Location fields. However, you can combine Location with other fields (e.g., Region or Site Type) to control workflows or trigger geofencing rules in your processes.

Troubleshooting

  • If the map doesn’t load, check your Google Maps API key in Organization Settings.
  • If auto-detection fails, confirm browser permissions and GPS availability on the device.
  • Enable reverse geocoding in Google Maps if you want formatted addresses stored.

Tip: For mobile-first workflows, enable Both Options so on-the-go users can auto-capture their location, while desktop users can pick a point manually.