POST api/v1/devices/{deviceId}/location
Set the devices current location. Use this in preference to setting the location object of the device when updating.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
deviceId | globally unique identifier |
Required |
Body Parameters
SetLocationDtoName | Description | Type | Additional information |
---|---|---|---|
Latitude | decimal number |
None. |
|
Longitude | decimal number |
None. |
|
Elevation | decimal number |
None. |
Request Formats
application/json, text/json, application/senml+json
Sample:
{ "Latitude": 1.1, "Longitude": 2.1, "Elevation": 3.1 }
application/xml, text/xml
Sample:
<SetLocationDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.DeviceLocation"> <Elevation>3.1</Elevation> <Latitude>1.1</Latitude> <Longitude>2.1</Longitude> </SetLocationDto>
application/x-www-form-urlencoded
Sample:
Sample not available.
Response Information
Resource Description
Collection of LocationDtoName | Description | Type | Additional information |
---|---|---|---|
Name |
Friendly name for the location |
string |
None. |
Latitude | decimal number |
None. |
|
Longitude | decimal number |
None. |
|
Elevation | decimal number |
None. |
|
WellKnownLocationId | globally unique identifier |
None. |
|
LastUpdated | date |
None. |
Response Formats
application/json, text/json, application/senml+json
Sample:
[ { "Name": "sample string 1", "Latitude": 2.1, "Longitude": 3.1, "Elevation": 4.1, "WellKnownLocationId": "fa65a8c2-9560-4dbc-8cca-42bd02476797", "LastUpdated": "2024-12-13T22:17:25.8917373+00:00" }, { "Name": "sample string 1", "Latitude": 2.1, "Longitude": 3.1, "Elevation": 4.1, "WellKnownLocationId": "fa65a8c2-9560-4dbc-8cca-42bd02476797", "LastUpdated": "2024-12-13T22:17:25.8917373+00:00" } ]
application/xml, text/xml
Sample:
<ArrayOfLocationDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared"> <LocationDto> <Elevation>4.1</Elevation> <LastUpdated>2024-12-13T22:17:25.8917373+00:00</LastUpdated> <Latitude>2.1</Latitude> <Longitude>3.1</Longitude> <Name>sample string 1</Name> <WellKnownLocationId>fa65a8c2-9560-4dbc-8cca-42bd02476797</WellKnownLocationId> </LocationDto> <LocationDto> <Elevation>4.1</Elevation> <LastUpdated>2024-12-13T22:17:25.8917373+00:00</LastUpdated> <Latitude>2.1</Latitude> <Longitude>3.1</Longitude> <Name>sample string 1</Name> <WellKnownLocationId>fa65a8c2-9560-4dbc-8cca-42bd02476797</WellKnownLocationId> </LocationDto> </ArrayOfLocationDto>