Geo Distance Editor

Editor for a geographic distance filter condition in the search filter builder.

Remarks

The GeoDistance Editor is a UI component in the Grooper search filter builder, designed to let users define and edit a geographic distance condition for filtering search results. It is used when you need to restrict search results to items located within a specified distance from a given geographic point (latitude and longitude).

Purpose and Functionality

The GeoDistance Editor enables users to:

• Select a geographic field (of type Edm.GeographyPoint) from the available filterable fields.
• Enter latitude and longitude coordinates to define the center point for the distance filter.
• Specify a distance value (e.g., 5km, 10mi) to set the search radius.
• View tooltips for guidance on entering location and distance values.
• Remove the condition using the {Delete} button.

The editor ensures that only valid geographic fields can be selected and provides contextual tooltips to assist with correct data entry.

Available Operators

The following comparison operators are available for building filter conditions:

• = (eq): Equal to
• != (ne): Not equal to
• < (lt): Less than
• > (gt): Greater than
• <= (le): Less than or equal to
• >= (ge): Greater than or equal to
• =∅: Equal to null (field is empty)
• ≠∅: Not equal to null (field is not empty)

Example

The following diagram illustrates the typical layout of the GeoDistance Editor:

┌──────────────────────────────────────────────────────────────────────────────────────────────┐
│ {Field Selector} {Operator Select} {Distance Input} km from {Location Input}        {Delete} │
└──────────────────────────────────────────────────────────────────────────────────────────────┘

• {Field Selector}: Dropdown to choose the geographic field.
• {Operator Selector}: The comparison operator.
• {Location Input}: Input for latitude and longitude (e.g., 35.4676 -97.5164).
• {Distance Input}: Input for the distance (e.g., 10mi).
• {Delete}: Button to remove this condition.
• Tooltip area provides context for entering valid values.

Usage Guidance

• Use the GeoDistance Editor to add, edit, or remove spatial filter conditions in the search builder.
• Tooltips provide instructions for entering coordinates and distance values.
• Only fields of type Edm.GeographyPoint are available for selection.
• Removing a condition is done by clicking the {Delete} button.

For more information on spatial filtering, see the documentation for Search Page and Filter Editor.

Command Buttons

Button	Shortcut Key		Summary
menu menu			Open the menu.
delete delete			Delete this condition.
open_jam add_parent_group			Add a new parent group above this condition.