Map a CoT Point Report
Cursor on Target (CoT) is an XML message format for sharing an entity’s type, location, and time. This example maps a CoT point report to a ground unit Object in [R]DP, so clients can show its latest position while retaining the original XML for custom details.
Source data
CoT wraps messages in XML event elements, even when they describe a continuing unit. In this CoT 2.0 example, sender demo.example assigns uid to one unit for its lifetime. The callsign is its display name.
Coordinates use WGS-84, the geographic reference used by GPS. Alongside the XML, the input supplies capture time 2026-10-01T12:00:02Z and message ID cot-report-001. The source reference retains the original UTF-8 text:
<event version="2.0" uid="demo-track-7" type="a-f-G-U-C" how="m-g" time="2026-10-01T12:00:00Z" start="2026-10-01T12:00:00Z" stale="2026-10-01T12:05:00Z">
<point lat="38.0" lon="-77.0" hae="120.0" ce="5.0" le="8.0"/>
<detail><contact callsign="DEMO-7"/><demo:profile xmlns:demo="urn:example:cot" mode="training"/></detail>
</event>
Field mapping
CoT’s type, position, and timestamps let clients display the unit and tell whether its location is still current. WDM gives those values common fields that clients can read, while the original XML preserves the remaining details.
For military map display, a Symbol Identification Code (SIDC) identifies the marker to draw. This example maps the recognized CoT type to MIL-STD-2525C symbology.
| Source | WDM field | Explanation |
|---|---|---|
Authority and |
|
|
|
|
|
|
|
This type describes a friendly ground combat unit, giving |
Recognized |
|
|
|
|
Latitude and longitude copy directly. Height above ellipsoid (HAE) is measured from Earth’s modeled reference surface, so |
|
|
|
Full XML, including |
|
A |
externalRefs retains the full XML, including the collection hint how, position-error estimates ce and le, and custom demo:profile extension, so consumers can interpret them using the source profile. Motion stays unset because the message supplies none.
WDM Object
The Object below uses ProtoJSON, protobuf’s JSON representation. See Publish Object for how to send it.
{
"id": "cot:demo.example:demo-track-7",
"security": {
"raw": "UNCLASSIFIED",
"components": {
"classification": "UNCLASSIFIED",
"ownerProducer": [
"USA"
]
}
},
"identities": [
{
"system": "cot:demo.example",
"identifier": "demo-track-7"
}
],
"flags": {
"isSimulated": true
},
"status": "OBJECT_STATUS_ACTIVE",
"ttl": "2026-10-01T12:05:00Z",
"provenance": {
"id": "cot-report-001",
"name": "CoT demo origin",
"updatedAt": "2026-10-01T12:00:00Z",
"producer": "example-cot-adapter-v1"
},
"name": "DEMO-7",
"ontology": {
"category": "ONTOLOGY_CATEGORY_UNIT"
},
"location": {
"position": {
"latitudeDegrees": 38.0,
"longitudeDegrees": -77.0,
"altitudeHaeMeters": 120.0
}
},
"assessment": {
"affiliation": "AFFILIATION_FRIEND",
"environment": "ENVIRONMENT_SURFACE"
},
"symbology": {
"sidc": "SFGPUC---------",
"version": "SIDC_VERSION_2525C"
},
"externalRefs": [
{
"typeUrl": "type.googleapis.com/google.protobuf.Struct",
"externalId": "demo-track-7",
"sourceSystem": "cot-demo-origin",
"payload": {
"@type": "type.googleapis.com/google.protobuf.Struct",
"value": {
"@type": "com.example.mapping.v1.CotSourceRecord",
"value": {
"format": "CoT",
"profile": "CoT 2.0 demonstration ground-unit profile",
"mediaType": "application/xml",
"representation": "original_record",
"encoding": "UTF-8",
"originalByteLength": 335,
"sha256": "6dd243c634e8d109ec017d98cfe365d5a22b0c908da89686eb332acb8be61bc4",
"rawText": "<event version=\"2.0\" uid=\"demo-track-7\" type=\"a-f-G-U-C\" how=\"m-g\" time=\"2026-10-01T12:00:00Z\" start=\"2026-10-01T12:00:00Z\" stale=\"2026-10-01T12:05:00Z\">\n <point lat=\"38.0\" lon=\"-77.0\" hae=\"120.0\" ce=\"5.0\" le=\"8.0\"/>\n <detail><contact callsign=\"DEMO-7\"/><demo:profile xmlns:demo=\"urn:example:cot\" mode=\"training\"/></detail>\n</event>\n"
}
}
},
"capturedAt": "2026-10-01T12:00:02Z",
"label": "Original CoT XML"
}
]
}
See Stable Identity and Links and Preserve Source Data for IDs and payload packing.