# KPN Global Tracker Wired

<figure><img src="https://portal.kpnthings.com/assets/images/device-types/kpn-global-tracker-wired.png" alt="" width="375"><figcaption><p>KPN Global Tracker Wired</p></figcaption></figure>

A wired 2G/LTE-M Tracking device with GPS.

* Supported network type(s): `KPNSTREAMLINEM2M`
* Device Specification ID: `kpn-global-tracker-wired`
* Device Specification UUID: `7c81c9a6-02e3-46f2-ac68-a300927b5535`

| Decoders                                 | decoderSpecificationUUID               | Description                                       |
| ---------------------------------------- | -------------------------------------- | ------------------------------------------------- |
| Decoded M2M Data for GlobalTracker Wired | `58a31b2d-05f1-5e4b-a531-18d4f896dbd7` | Decoder for M2M KPN Global Tracker Wired devices. |

### Decoded M2M Data for GlobalTracker Wired

Decoder for M2M KPN Global Tracker Wired devices.

The following SenML records can be present, amongst others:

<table><thead><tr><th>name</th><th width="99">type</th><th width="80">unit</th><th>example</th><th>description</th></tr></thead><tbody><tr><td>altitude</td><td></td><td>m</td><td></td><td>The measured altitude</td></tr><tr><td>batteryVoltage</td><td>number</td><td>V</td><td><code>3.59</code></td><td></td></tr><tr><td>firmwareVersion</td><td>string</td><td></td><td></td><td>Not present in detail level 1 messages</td></tr><tr><td>gpsTime</td><td>number</td><td>s</td><td></td><td>Unix EPOCH time in seconds</td></tr><tr><td>gsmNetworkId</td><td>string</td><td></td><td></td><td></td></tr><tr><td>eventDescription</td><td>string</td><td></td><td><ul><li><code>"Start moving"</code></li><li><code>"Stop moving"</code></li><li><code>"While moving"</code></li><li><code>"While not moving"</code></li></ul></td><td>Description of the device event. Not present in detail level 1 messages.</td></tr><tr><td>eventId</td><td>string</td><td></td><td><ul><li><code>"40"</code> (Stop moving)</li><li><code>"41"</code> (Start moving)</li><li><code>"44"</code> (While moving)</li><li><code>"45"</code> (While not moving)</li></ul></td><td>Id of the device event. Not present in detail level 1 messages</td></tr><tr><td>gpsStatus</td><td>string</td><td></td><td><ul><li><code>"0"</code> (OK)</li><li><code>"1"</code> (Speed/heading invalid)</li><li><code>"32"</code> (Accuracy not met)</li><li><code>"33"</code> (Accuracy not met + Speed/heading invalid)</li></ul></td><td>Identifier indicating the GPS Status</td></tr><tr><td>gpsNotes</td><td>string</td><td></td><td><ul><li><code>"OK"</code></li><li><code>"Accuracy not met"</code></li><li><code>"Speed/heading invalid"</code></li><li><code>"Accuracy not met + Speed/heading invalid"</code></li></ul></td><td>Description of the GPS Status</td></tr><tr><td>heading</td><td>number</td><td>rad</td><td></td><td>Direction in radials. Not present in detail level 1 messages</td></tr><tr><td>latitude</td><td>number</td><td>lat</td><td></td><td>Latitude of the device. Not present in detail level 1 messages</td></tr><tr><td>longitude</td><td>number</td><td>lon</td><td></td><td>Longitude of the device. Not present in detail level 1 messages</td></tr><tr><td>radius</td><td>number</td><td>m</td><td></td><td>Radius indicating the precision of the positition. Not present in detail level 1 messages</td></tr><tr><td>switch</td><td>string</td><td></td><td><ul><li><code>"0"</code> (Position)</li><li><code>"53"</code> (SV_CountersUser)</li><li><code>"64"</code> (SV_Network)</li><li><code>"77"</code> (TimeAlive)</li></ul></td><td>Identifier indicating the record-type. In case Switch=77, there has been no GPS Fix and the Geo coordinates belong to the previous GPS Fix.</td></tr><tr><td>switchName</td><td>string</td><td></td><td><ul><li><code>"SV_Position"</code></li><li><code>"SV_CountersUser"</code></li><li><code>"SV_Network"</code></li><li><code>"SV_TimeAlive"</code></li></ul></td><td>Name of this record-type.</td></tr><tr><td>temperature</td><td>number</td><td>Cel</td><td></td><td>The measured temperature</td></tr><tr><td>velocity</td><td>number</td><td>m/s</td><td></td><td>Velocity of the device. Not present in detail level 1 messages</td></tr></tbody></table>

#### Example SenML

{% hint style="info" %}
SenML can be structured in different ways, and we do not guarantee the examples below will look the same as what you will receive on your Destination. To make sure you can handle the SenML optimally, take a look at our documentation about [Understanding and Interpreting SenML Data](/kpn-things/building-blocks/data-processing/thingsml-and-senml/senml/understanding-and-interpreting-senml-data.md).
{% endhint %}

**Detail level 1 (SV\_CountersUser)**

```json
[
  {
    "bn": "urn:dev:IMEI:999999999000090:",
    "bt": 1664818024.4,
    "n": "batteryVoltage",
    "u": "V",
    "v": 0.8
  },
  {
    "n": "gpsTime",
    "u": "s",
    "v": 1696501006.08
  },
  {
    "n": "switch",
    "vs": "53"
  },
  {
    "n": "switchName",
    "vs": "SV_CountersUser"
  }
]
```

**Detail level 2 (SV\_Network)**

```json
[
  {
    "bn": "urn:dev:IMEI:863740069987078:",
    "bt": 1664818024.4,
    "n": "batteryVoltage",
    "u": "V",
    "v": 15.68
  },
  {
    "n": "firmwareVersion",
    "vs": "564"
  },
  {
    "n": "gpsTime",
    "u": "s",
    "v": 1696582683.52
  },
  {
    "n": "gsmNetworkId",
    "vs": "20408"
  },
  {
    "n": "switch",
    "vs": "64"
  },
  {
    "n": "switchName",
    "vs": "SV_Network"
  }
]
```

**Detail level 3 (SV\_Position)**

```json
[
  {
    "bn": "urn:dev:IMEI:863740062764946:",
    "bt": 1664818024.4,
    "n": "altitude",
    "u": "m",
    "v": 63
  },
  {
    "n": "batteryVoltage",
    "u": "V",
    "v": 3.87
  },
  {
    "n": "eventDescription",
    "vs": "?1?"
  },
  {
    "n": "eventId",
    "vs": "1"
  },
  {
    "n": "firmwareVersion",
    "vs": "69"
  },
  {
    "n": "gpsNotes",
    "vs": "OK"
  },
  {
    "n": "gpsStatus",
    "vs": "0"
  },
  {
    "n": "gpsTime",
    "u": "s",
    "v": 1696499003.04
  },
  {
    "n": "heading",
    "u": "rad",
    "v": 0
  },
  {
    "n": "latitude",
    "u": "lat",
    "v": 52.04044
  },
  {
    "n": "longitude",
    "u": "lon",
    "v": 4.40817
  },
  {
    "n": "radius",
    "u": "m",
    "v": 9.5
  },
  {
    "n": "switch",
    "vs": "0"
  },
  {
    "n": "switchName",
    "vs": "SV_Position"
  },
  {
    "n": "temperature",
    "u": "Cel",
    "v": 22.5
  },
  {
    "n": "velocity",
    "u": "m/s",
    "v": 0
  }
]
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kpnthings.com/kpn-things/building-blocks/devices/trackers/kpn-global-tracker-wired.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.