GPSCoordinatePairValidator

GPSCoordinatePairValidator

Validates a user-selected latitude and longitude pair for structural eligibility in decimal-degree GPS analysis.

Each input feature is returned with a prefixed validation status and result code. Multiple instances can be connected in series to validate different coordinate pairs without overwriting earlier results.

Typical Uses

Validate coordinate fields before GPS analysis

Screen coordinates before point creation or distance calculations

Apply consistent validation across multiple source systems

Support GPS reconciliation workflows

Parameters

Select Latitude Attribute

The attribute containing the latitude value.

Select Longitude Attribute

The attribute containing the longitude value.

Enter Coordinate Pair Code

A short identifier for the coordinate pair.

This value is added as a prefix to the output attributes.

Exclude Null Island

Controls whether the coordinate pair (0,0) is considered ineligible.

Enabled: (0,0) returns INELIGIBLE with code NULL_ISLAND.

Disabled: (0,0) may pass structural validation.

Validation Criteria

A coordinate pair is classified as ELIGIBLE when:

Both selected attributes are present and populated.

Both values are numeric.

Latitude is within [-90,90].

Longitude is within [-180,180].

The pair is not (0,0) when Exclude Null Island is enabled.

Missing, null, and empty values are treated as unavailable.

Output Attributes

The transformer creates two attributes prefixed with the configured Coordinate Pair Code:

<PAIR_CODE>_gpsv_structural_status

<PAIR_CODE>_gpsv_structural_code

The structural status is ELIGIBLE or INELIGIBLE. The structural code identifies the specific validation result.

Original input attributes are preserved, and temporary validation attributes are removed before output.

Multiple Coordinate Pairs

Connect multiple instances in series and assign each instance a unique coordinate-pair code. The prefixes preserve each pair's results without overwriting results from earlier instances.

Notes

This transformer evaluates structural eligibility only. It does not verify positional accuracy, coordinate reference system, regional plausibility, boundary-overlay results, or agreement with another location source.