Sending Position Events to Atrius
To send position events to the Atrius platform, please follow steps below:
Step 1 – Get A Shared Access Signature (SAS)
All positions events posted to the Atrius platform should contain an authorization header with SharedAccessSignature. Each successful call to the Navigator Initialization API will result in a Response Body that contains both the endpoint URI and an access token which can be used to formulate a HTTP POST.
Step 2 – Build the Request Body
Below you’ll find a sample event message’s Request Body which can be sent to the endpoint URI
[
{
"pk": "65cd5987-3b24-4c3b-bbff-84e1a4f3951f", //(string) - Partner Key Identifier
"o": 1, //(int | optional) - Organization Identifier
"sid": 21, //(int | optional) - Site Identifier
"f": 90, //(int | optional) - Floor Identifier
"s": 143, //(int) - Floor Space Identifier
"p": "v", //(string) - Capture Type Pick from Following (b, v, ble, vlc, cloudtrax, cisco, trilateration)
"i": "ABL-G-I-7A8B881C-9352-4470-91B5-50BD4C0730DD”, //(string) - Unique Device Identifier
"pid": null, //(varchar | optional) - Unique Position Identifier (we calc)
"t": "2015-12-30T16:46:55.107+0000”, //(string | optional) - Timestamp Received (ISO 8601 - UTC)
"x": 4, //(float | optional) - Local X Coordinate on Lights Map (meter) (optional if longitude exists)
"y": 2.54161, //(float | optional) - Local Y Coordinate on Lights Map (meter) (optional if latitude exists)
"z": 0, //(float | optional) - Local Z Coordinate (meter)
"cx": 2.54161, //(float | optional) - Client Converted Local X Coordinate (meter)
"cy": 4, //(float | optional) - Client Converted Local Y Coordinate (meter)
"ca": 90.00002, //(float | optional) - Client Converted Local Orientation (degree)
"lon": 0.0, //(double | optional) - Longitude (decimal degrees) (optional if x exists)
"lat": 0.0, //(double | optional) - Latitude (decimal degrees) (optional if y exists)
"a": 180, //(float | optional) - Orientation (degree)
"aid": "com.company.appname", //(string | optional) - Application ID
"d": "iOS", //(string | optional) - Device OS Name
"dv": "15.4.1", //(string | optional) - Device OS Version
"bp": 0.5, //(float | optional) - Device Battery %
"sv": "6.4.3", //(string | optional) - SDK Version
"do": "PortraitUpsideDown", //(string | optional) - Device orientation
"hd": null, //(float | optional) - Heading (degree)
"h": null, //(float | optional) - Elevation
"cn": 39.0, //(float | optional) - Closest Node Distance (meter)
"cs": "83b887f0-6749-42f3-a77d-2e12666b9a70", //(string | optional) - Closest Sensor Name
"os": null, //(bool | optional) - Position is outside a zone, but inside a capture area
"oid": null, //(string(6) | optional) - Manufacturer OID
"f1": 1, //(int | optional) - Custom Property Lookup 1
"f2": 2, //(int | optional) - Custom Property Lookup 2
"f3": 3, //(int | optional) - Custom Property Lookup 3
"f4": 4, //(int | optional) - Custom Property Lookup 4
"f5": 5, //(int | optional) - Custom Property Lookup 5
"f6": 6, //(int | optional) - Custom Property Lookup 6
"f7": 7, //(int | optional) - Custom Property Lookup 7
"f8": 8, //(int | optional) - Custom Property Lookup 8
},
{...}
]
Step 3 – Make a HTTP POST Request
Utilizing the values from steps 1 and 2 above, make a HTTP POST request as necessary>