LoRa Geolocation and Local Gateway decoding

Describes the LoRa Geolocation and Local gateway decoding output

LoRa messages may contain Local Gateway data and Geolocation data based on your Connectivity Plan. If you are using one of the official decoders for a LoRa device and the necessary data is present, then this data will be added to resulting SenML payload.

Note that the deprecated decoders related to the Decoder Migration do not add these records.

You can expect the following data to be added:

Geolocation data

name	type	unit	example	description
latitude	number	lat	4.12
locAccuracy	number	%	9999
locMethod	string		"RSSI"
locOrigin	string		"KPNLORA"
locPrecision	number	%	9999
locTime	number		1585250717
longitude	number	lon	10.12
radius	number	m	17.3

Local Gateway data

If there is any Local Gateway data, the following fields will be added.

name	type	unit	example	description
detectedBeacon	string		"FF010249"
detectedBeaconSNR	string		"2"
DvLocOrigin	string		"KPNLORALRR"
DvLocOriginID	string		"10"
DvLocTime	string		"2023-09-19T14:45:42.724Z"

In addition, for each Local Gateway the following fields may be added where i is replaced by the index of the gateway (starting with 1)

name	type	unit	example	description
beacon_i	string		"FF010249"	The identifier of the beacon. Always present. For the first beacon the name is beacon_1.
DvLocation	string		"somewhere"	Present if this beacon received this uplink.
DvNearByLoc	string		"elsewhere"	Present if this beacon did not receive this uplink.

Example SenML

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.

[
  {
    "bn": "urn:dev:DEVEUI:0123456789012345:",
    "bt": 1.585250717E9,
    "n": "locOrigin",
    "vs": "KPNLORA"
  },
  {
    "n": "latitude",
    "u": "lat",
    "v": 4.12
  },
  {
    "n": "longitude",
    "u": "lon",
    "v": 10.12
  },
  {
    "n": "radius",
    "u": "m",
    "v": 17.3
  },
  {
    "n": "locMethod",
    "vs": "RSSI"
  },
  {
    "n": "locAccuracy",
    "u": "%",
    "v": 9999
  },
  {
    "n": "locPrecision",
    "u": "%",
    "v": 9999
  },
  {
    "n": "locTime",
    "v": 1.585250717E9
  },
  {
    "n": "DvLocTime",
    "vs": "2023-09-19T14:45:42.724Z"
  },
  {
    "n": "DvLocOrigin",
    "vs": "KPNLORALRR"
  },
  {
    "n": "DvLocOriginID",
    "vs": "10"
  },
  {
    "n": "detectedBeacon",
    "vs": "FF010249"
  },
  {
    "n": "detectedBeaconSNR",
    "vs": "2"
  },
  {
    "n": "DvLocation",
    "vs": "somewhere"
  },
  {
    "n": "beacon_1",
    "vs": "FF010249"
  },
  {
    "n": "DvNearByLoc",
    "vs": "elsewhere"
  },
  {
    "n": "beacon_2",
    "vs": "080E02B1"
  }
]