Parse live position
position.parseParse 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 JSON
sourceString 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 session
epochText The reference epoch, which must match the data source.
OptionalDefault:""- Maximum characters: 128
- Coordinate frame
frameText The coordinate-frame ID; connected data should use the same reference.
OptionalDefault:"world"- Minimum characters: 1
- Maximum characters: 128
- Camera heading field
headingFieldText 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 unit
unitText The coordinate unit, matching the connected coordinate reference.
OptionalDefault:"world"- Minimum characters: 1
- Maximum characters: 32
- Validity field
validFieldText The JSON field mapping indicating whether the position is valid.
OptionalDefault:"valid"- Minimum characters: 1
- Maximum characters: 128
- First axis field
xFieldText The JSON field mapping for X.
OptionalDefault:"x"- Minimum characters: 1
- Maximum characters: 128
- Second axis field
yFieldText The JSON field mapping for Y.
OptionalDefault:"y"- Minimum characters: 1
- Maximum characters: 128
Data outputs 1
- Live position
positionLive 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
- Input
inInput · Control - An incoming control signal enters this operation.
- Done
doneOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Failed
failedOutput · Error - Emitted when the operation fails; connect error handling here.
Version and node identity
Version 1.0.0
sha256:fa69f160e442c587858533eed1cac68dd61aaec1220b6acf9b3d978380d42e51