Specification
[environmentreportOrigin]
{
"latitudetestDeviceType": floatstring number, --> latitude in degrees,decimal fractional minutes (note: we do not use this information anymore, yet it cannot be empty)
"longitude": float number, typical values are "wifiprobe", "NetTest", "boomerang" to distinguish between measurement tools
"testDeviceVersion": string --> version of the tool used (e.g. 1.0)
"testDeviceId": string --> longitude in degrees,decimal fractional minutes (note: we do not use this information anymore, yet it cannot be empty) ID (e.g. MAC address) of device used for preforming the test
"testInstanceUniqueId": string --> a unique identifier for this result set
"altitudetestStartTimestamp": floatstring number, --> altitude in meters(it can be empty) UTC date & time when the test has been started (YYYY-MM-DD hh:mm:ss)
"locationNametestFinishedTimestamp": string, --> UTC date & time when -->the test has testedbeen location namecompleted (YYYY-MM-DD hh:mm:ss)
}
[environment]
{
"latitude": float number, can be empty)
"locationMethod": string, --> typical latitude valuesin are 'Through IP' or 'Geolocation' degrees,decimal fractional minutes (note: we do not use this information anymore, yet it cannot be empty)
"testToolTypelongitude": string float number, --> longitude --> typical values are "wifiprobe", "NetTest", "boomerang" to distinguish between measurement tools in degrees,decimal fractional minutes (note: we do not use this information anymore, yet it cannot be empty)
"testToolTypeVersionaltitude": string float number, --> version of the tool used (e.g. 1.0) altitude in meters(it can be empty)
"testDeviceIdlocationName": string string, --> > ID (e.g. MACtested address)location ofname device(can used for preforming the testbe empty)
"testDeviceLocationDescription": string --> describes the location of the test device
}
[test-description]
{
"testType "locationMethod": string, --> describes typical thevalues exactare test (e.g. wifiscan, netperformance, ...)
"testInstanceID": string --> measurement ID (unique hash generated by the test device)
"testTimeStamp": string --> date & time when the test has been performed (YYYY-MM-DD hh:mm:ss)
}
[test-result]
{
"executionTime": float number'Through IP' or 'Geolocation' (note: we do not use this information anymore, yet it cannot be empty)
"wifiSurround": array --> timelist neededof for the test to be performedSSIDs found
"wifiSurroundaccessPointVisibleSSIDCount": string integer --> number of Wi-Fi cells with a normally visible SSID
"accessPointHiddenSSIDCount": integer --> listnumber of SSIDs found
Wi-Fi cells with a "hidden" SSID
}
[connectivity]
{
"eduroamPresenceeduroamAuthnSuccessful": string --> result of -->eduroam AuthN (true Yes/Noor false)
"eduroamAuthnResultipv4Connectivity": stringfloat number --> time needed to resultget ofvalid eduroamIPv4 AuthN (Yes / No)address; -1=no connectivity;
"eduroamConnectivityipv6Connectivity": float number --> time needed to get valid IPIPv6 address; 0-1=no connectivity;
}
[performance]
{
"downloadThroughput": float number, --> download download speed in KBps (note: we use one decimal digit)
"uploadThroughput": float number, --> > uploadupload speed in KBps (note: we use one decimal digit)
"localPingipv4LocalPing": float number, --> IPv4 ping time in ms (note: we --> pinguse one decimal digit)
"ipv6LocalPing": float number, --> IPv6 ping time in ms (note: we use one decimal digit)
}
...
JSON message example (syntax to be
...
verified)
[reportOrigin]
{
"testDeviceType": "Frankenprobe",
"testDeviceVersion": 1.0,
"testDeviceId": "00-11-22-33-44-55",
"testInstanceUniqueId": "13df2a-671bbfa5697-13245-67713af",
"testStartTimestamp": "2017-09-13 15:00:00",
"testFinishedTimestamp": "2017-09-13 15:02:19",
}
[environment]
{
"latitude": 38.25,
"longitude": 21.73,
"altitude": -213.45,
"locationName": "Subterranean University, Main Building",
"testDeviceLocationDescription": "rector's office, hidden behind the 'A Starry Night' van Gogh painting on the rear wall",
"locationMethod": "'Through IP'"Differential Indoor GPS",
"wifiSurround": [ "eduroam", "drillTest", "geological_symposium" ] ,
"accessPointVisibleSSIDCount": 7,
"accessPointHiddenSSIDCount": 1,
}
[connectivity]
{
"eduroamAuthnSuccessful": true,
"ipv4Connectivity": 0.672,
"ipv6Connectivity": -1,
}
[performance]
{
"downloadThroughput": 4375.0,
"uploadThroughput": 3912.5,
"localPing": 4.7,
"testTool": "wifiprobe"
}