The Position Object is used to record location fixes for Devices, such as GPS trackers or physical check-ins. Objects in this Collection need to be linked to existing Objects in the assets.device Collection.
This Object is structured primarily to support the GPS feature of the SPACEtag® IoT Module, however you can use it for your own GPS or other feeds if required.
Module: Assets
Collection: AssetPositions
Object: assets.position
| Friendly Field Name | Data Field Name | General Data Type | Description | Optimised for Searching |
|---|---|---|---|---|
| Unique Identifier | uuid | UUID | Unique identifier for each position record. | Yes |
| Application Identifier | app_uuid | UUID | Identifier for the associated application. | Yes |
| Application Context Reference | app_context_ref | Text (max length 50) | You can use this field to provide searchable context to your object – for example this may be an external identifier, or a lookup UUID to another object in your application. | Yes |
| Device Identifier | device_uuid | UUID | Identifier of the device providing the position – linked to an assets.device object. The Device Object must already exist in that Collection, otherwise an error will occur when creating the new Object.Required | Yes |
| Protocol | protocol | Text (max length 128) | Protocol used to receive the data. | No |
| Server Time | server_time | DateTime | Timestamp when the server received the data. | Yes |
| Device Time | device_time | DateTime | Timestamp according to the device. | Yes |
| Fix Time | fix_time | DateTime | Timestamp when the position was fixed. | Yes |
| Is Valid | is_valid | Boolean | Indicates whether the position data is valid. | No |
| Latitude | latitude | Number | Latitude coordinate. | No |
| Longitude | longitude | Number | Longitude coordinate. | No |
| Altitude | altitude | Number | Altitude (usually in meters). | No |
| Speed | speed | Number | Speed at the time of position fix. | No |
| Course | course | Number | Course or direction of travel. | No |
| Address | address | Text (max length 512) | Address associated with the position. | No |
| Attributes | attributes | Text | Additional attributes of the position. | No |
| Accuracy | accuracy | Number | Accuracy of the position fix. | No |
| Network | network | Text | Information about the network used. | No |
| Geofence IDs | geofenceids | Text (max length 128) | Identifiers of associated geofences. | No |
| Data Source | data_source | Text (max length 100) | Source of the position data. | Yes |
| Taxonomy | position_taxonomy | Text (max length 50) | Internal categorisation for the identifier. | Yes |
| Created At | created_at | DateTime | Timestamp when the record was created. | No |
| Updated At | updated_at | DateTime | Timestamp when the record was last updated. | No |
| Created By | created_by | Text (max length 50) | You can use this field to record who or what created the Object record. | No |
| Updated By | updated_by | Text (max length 50) | You can use this field to record who or what last updated the Object record. | No |