中文
Node Documentation

Parse live position

AutomationTarget independentposition.parse

Parse JSON coordinates using field mappings; invalid or stale observations are marked unavailable.

Example use

Parse JSON position text from a plugin using field mappings for navigation.

Node preview

Right-drag to pan and scroll to zoom. Expand inputs and edit parameters to see how ports change. This preview does not run the node; reopening the page restores the example.

Loading node preview…

Data inputs 1

Position JSONsourceString

JSON containing coordinates, heading, validity and sample time.

RequiredDefault: None

Configuration 10

Heading of positive first axis (°)axisHeadingNumber

The heading associated with the reference axes.

OptionalDefault: 0
Coordinate angle direction (1 or -1)axisSignChoice

The axis direction convention, matching the position source.

OptionalDefault: 1
  • Options: -1, 1
Observation sessionepochText

The reference epoch, which must match the data source.

OptionalDefault: ""
  • Maximum characters: 128
Coordinate frameframeText

The coordinate-frame ID; connected data should use the same reference.

OptionalDefault: "world"
  • Minimum characters: 1
  • Maximum characters: 128
Camera heading fieldheadingFieldText

The JSON field mapping for heading.

OptionalDefault: "cameraHeading"
  • Minimum characters: 1
  • Maximum characters: 128
Sample time field (Unix ms)timeFieldText

The JSON field mapping for sample time.

OptionalDefault: "sampleTimeMs"
  • Minimum characters: 1
  • Maximum characters: 128
Coordinate unitunitText

The coordinate unit, matching the connected coordinate reference.

OptionalDefault: "world"
  • Minimum characters: 1
  • Maximum characters: 32
Validity fieldvalidFieldText

The JSON field mapping indicating whether the position is valid.

OptionalDefault: "valid"
  • Minimum characters: 1
  • Maximum characters: 128
First axis fieldxFieldText

The JSON field mapping for X.

OptionalDefault: "x"
  • Minimum characters: 1
  • Maximum characters: 128
Second axis fieldyFieldText

The JSON field mapping for Y.

OptionalDefault: "y"
  • Minimum characters: 1
  • Maximum characters: 128

Data outputs 1

Live positionpositionLive position

Write to a position variable for continuous navigation.

Value format examples
{"axisHeading":0,"axisSign":1,"epoch":"","frame":"world","heading":0,"receivedAt":0,"sampleAt":0,"sequence":0,"unit":"world","valid":false,"x":0,"y":0}

Control and error ports

InputinInput · Control
An incoming control signal enters this operation.
DonedoneOutput · Control
Continue from this result or stage; see the node description for branch conditions.
FailedfailedOutput · Error
Emitted when the operation fails; connect error handling here.
Version and node identity

Version 1.0.0

sha256:fa69f160e442c587858533eed1cac68dd61aaec1220b6acf9b3d978380d42e51