GET api/v1/devices/{deviceId}/location?sortOrder={sortOrder}&startDate={startDate}&endDate={endDate}
Get the devices location history.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
deviceId | globally unique identifier |
Required |
|
sortOrder | SortOrder |
Default value is Asc |
|
startDate | string |
None. |
|
endDate |
Leave empty for all locations upto the current time. |
string |
None. |
Body Parameters
None.
Response Information
Resource Description
DeviceLocationHistoryDtoName | Description | Type | Additional information |
---|---|---|---|
History | Collection of LocationHistoryDto |
None. |
|
Summary | LocationHistorySummary |
None. |
Response Formats
application/json, text/json, application/senml+json
Sample:
{ "History": [ { "Id": "7e83fc53-f554-4fc2-bdd9-3b1f90267f0e", "Name": "sample string 2", "Latitude": 3.1, "Longitude": 4.1, "Elevation": 5.1, "WellKnownLocationId": "c332a2f7-51b2-485a-9d27-abbb420ab626", "Date": "2024-12-03T10:19:36.8768475+00:00", "TimeAtLocationSeconds": 1, "DistanceTraveledMeters": 6.1 }, { "Id": "7e83fc53-f554-4fc2-bdd9-3b1f90267f0e", "Name": "sample string 2", "Latitude": 3.1, "Longitude": 4.1, "Elevation": 5.1, "WellKnownLocationId": "c332a2f7-51b2-485a-9d27-abbb420ab626", "Date": "2024-12-03T10:19:36.8768475+00:00", "TimeAtLocationSeconds": 1, "DistanceTraveledMeters": 6.1 } ], "Summary": { "TotalTimeSeconds": 1, "TotalDistanceMeters": 2.1 } }
application/xml, text/xml
Sample:
<DeviceLocationHistoryDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.DeviceLocation"> <History> <LocationHistoryDto> <Date>2024-12-03T10:19:36.8768475+00:00</Date> <DistanceTraveledMeters>6.1</DistanceTraveledMeters> <Elevation>5.1</Elevation> <Id>7e83fc53-f554-4fc2-bdd9-3b1f90267f0e</Id> <Latitude>3.1</Latitude> <Longitude>4.1</Longitude> <Name>sample string 2</Name> <TimeAtLocationSeconds>1</TimeAtLocationSeconds> <WellKnownLocationId>c332a2f7-51b2-485a-9d27-abbb420ab626</WellKnownLocationId> </LocationHistoryDto> <LocationHistoryDto> <Date>2024-12-03T10:19:36.8768475+00:00</Date> <DistanceTraveledMeters>6.1</DistanceTraveledMeters> <Elevation>5.1</Elevation> <Id>7e83fc53-f554-4fc2-bdd9-3b1f90267f0e</Id> <Latitude>3.1</Latitude> <Longitude>4.1</Longitude> <Name>sample string 2</Name> <TimeAtLocationSeconds>1</TimeAtLocationSeconds> <WellKnownLocationId>c332a2f7-51b2-485a-9d27-abbb420ab626</WellKnownLocationId> </LocationHistoryDto> </History> <Summary> <TotalDistanceMeters>2.1</TotalDistanceMeters> <TotalTimeSeconds>1</TotalTimeSeconds> </Summary> </DeviceLocationHistoryDto>