Jump to

• Request
• Response

Retrieve Information about the Device Location

get

/iot/api/v2/devices/{device-id}/location

Returns location information for a device. If device does not provide location then returned object is empty.

Request

Path Parameters

• device-id: string
  ID of device to be retrieved from Cloud Service

Back to Top

Response

Supported Media Types

• application/json
• application/vnd.oracle.resource+json;type=singular

200 Response

Successfully processed.

Body ()

Root Schema : LocationImpl_receive

Type: object

Show Source

• altitude: integer
  Property description was not set
• lastModified: integer
  Property description was not set
• lastModifiedAsDate: integer
  Property description was not set
• latitude: integer
  Property description was not set
• longitude: integer
  Property description was not set
• uncertainty: integer
  Property description was not set

{
    "properties":{
        "altitude":{
            "description":"Property description was not set",
            "type":"integer"
        },
        "lastModified":{
            "description":"Property description was not set",
            "type":"integer"
        },
        "lastModifiedAsDate":{
            "description":"Property description was not set",
            "type":"integer"
        },
        "latitude":{
            "description":"Property description was not set",
            "type":"integer"
        },
        "longitude":{
            "description":"Property description was not set",
            "type":"integer"
        },
        "uncertainty":{
            "description":"Property description was not set",
            "type":"integer"
        }
    },
    "required":[
        "lastModifiedAsDate",
        "latitude",
        "longitude",
        "altitude",
        "uncertainty",
        "lastModified"
    ],
    "type":"object"
}

406 Response

Request Not Acceptable. The resource identified by the request is only capable of generating response entities which have content characteristics not acceptable according to the accept headers sent in the request.

Back to Top