Commands

Set the position of a Device

Set the position of the Device for x, y, z, yaw, pitch and roll. Pica will trigger the neighbor-updated event for every other device present in the scene closer that the maximum distance UINT16_MAX cm.

post/set-position/{mac-address}

Path parameters

mac-addressstring required

Valid UWB mac addresses must follow the above format

Short Mode: "XX:XX"
Extend Mode: "XX:XX:XX:XX:XX:XX:XX:XX" where X is an hexadecimal number.

Request body

xinteger

x coordinate in cm

yinteger

y coordinate in cm

zinteger

z coordinate in cm

yawinteger

yaw in degrees

pitchinteger

pitch in degrees

rollinteger

roll in degrees

Response

Success

Changes

Changed in 5 of the 5 revisions of this API.1026

Jul 17, 20267e54e3f9ba2511See the full diff
- ▲
  added required request body
  request-body-added-required
- ●
  deleted the query request parameter position-required
  request-parameter-removed
Aug 22, 2022657e36b2039b6See the full diff
- ○
  for the query request parameter position-required, the type/format of property pitch was generalized from integer/ to number/
  request-parameter-property-type-generalized
- ○
  for the query request parameter position-required, the type/format of property roll was generalized from integer/ to number/
  request-parameter-property-type-generalized
- ○
  for the query request parameter position-required, the type/format of property x was generalized from integer/ to number/
  request-parameter-property-type-generalized
- ○
  for the query request parameter position-required, the type/format of property y was generalized from integer/ to number/
  request-parameter-property-type-generalized
- ○
  for the query request parameter position-required, the type/format of property yaw was generalized from integer/ to number/
  request-parameter-property-type-generalized
- ○
  for the query request parameter position-required, the type/format of property z was generalized from integer/ to number/
  request-parameter-property-type-generalized
Aug 5, 2022657e36b2039b2See the full diff
- ▲
  added the new required query request parameter position-required
  new-required-request-parameter
- ▲
  removed the request body
  request-body-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 29, 2022df1e30abf42d11See the full diff
- ▲
  added required request body
  request-body-added-required
- ●
  deleted the query request parameter position-required
  request-parameter-removed
Jul 29, 2022c76afbc268ba6See the full diff
- ▲
  for the query request parameter position-required, the type/format of property pitch was specialized from number/ to integer/
  request-parameter-property-type-specialized
- ▲
  for the query request parameter position-required, the type/format of property roll was specialized from number/ to integer/
  request-parameter-property-type-specialized
- ▲
  for the query request parameter position-required, the type/format of property x was specialized from number/ to integer/
  request-parameter-property-type-specialized
- ▲
  for the query request parameter position-required, the type/format of property y was specialized from number/ to integer/
  request-parameter-property-type-specialized
- ▲
  for the query request parameter position-required, the type/format of property yaw was specialized from number/ to integer/
  request-parameter-property-type-specialized
- ▲
  for the query request parameter position-required, the type/format of property z was specialized from number/ to integer/
  request-parameter-property-type-specialized

Full history