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

NameDescriptionTypeAdditional information
deviceId

globally unique identifier

Required

Body Parameters

SetLocationDto
NameDescriptionTypeAdditional 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 LocationDto
NameDescriptionTypeAdditional 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": "3039c279-8aa4-4f47-86c9-f77a4c962be1",
    "LastUpdated": "2024-12-01T21:01:38.0219074+00:00"
  },
  {
    "Name": "sample string 1",
    "Latitude": 2.1,
    "Longitude": 3.1,
    "Elevation": 4.1,
    "WellKnownLocationId": "3039c279-8aa4-4f47-86c9-f77a4c962be1",
    "LastUpdated": "2024-12-01T21:01:38.0219074+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-01T21:01:38.0219074+00:00</LastUpdated>
    <Latitude>2.1</Latitude>
    <Longitude>3.1</Longitude>
    <Name>sample string 1</Name>
    <WellKnownLocationId>3039c279-8aa4-4f47-86c9-f77a4c962be1</WellKnownLocationId>
  </LocationDto>
  <LocationDto>
    <Elevation>4.1</Elevation>
    <LastUpdated>2024-12-01T21:01:38.0219074+00:00</LastUpdated>
    <Latitude>2.1</Latitude>
    <Longitude>3.1</Longitude>
    <Name>sample string 1</Name>
    <WellKnownLocationId>3039c279-8aa4-4f47-86c9-f77a4c962be1</WellKnownLocationId>
  </LocationDto>
</ArrayOfLocationDto>