An asset location provides information for an asset and the details of the location wherein the asset is contained at a given event time. The details of the location is recorded as latitude and longitude values.
Fields
Tag | Data Type | Description |
assetId | Integer | Internal identifier for asset contained in the zone. |
eventDate | Text | Timestamp when the asset was in this specific location. Note: Format is in timestamp and timezone (YYYY-MM-DDTHH:MM:SS.sssZ, e.g: 1970-01-01T00:00:00.000Z) |
latitude | Double Precision | Latitude of the location of the asset during the specified date. |
longitude | Double Precision | Longitude of the location of the asset during the specified date. |
Read
API PATH: | /api/v2/assetLocations |
METHOD: | GET |
PARAMETERS: | asset-id – Retrieves all matching records with the specified asset id (e.g. asset-id=1323661, all assets by default) offset – Retrieves matching records after an offset value (e.g. offset=2, zero offset by default) limit – Retrieves a number of records per page specified by the value (e.g. limit=10, all records by default) |
QUERY STRING EXAMPLES: | Get the asset location with the specific asset id: ?asset-id=1323661 Get two asset locations of the current account with an offset of 1 : ?offset=1&limit=2 |
EXAMPLE RESPONSE: |
[ { "assetId": 1323661, "eventDate": "2016-07-04T05:29:59.059Z", "latitude": 41.57869255, "longitude": -87.2928666 } ]
|
API error calls
ERROR MESSAGE | POSSIBLE CAUSES |
POST is not supported. | POST method is not allowed |
PUT is not supported. | PUT method is not allowed |
DELETE is not supported. | DELETE method is not allowed |