1. REST API for Oracle Mobile Cloud Service
  2. Tasks
  3. Location

Return a Device by ID

get

/mobile/platform/location/devices/{id}

Retrieves the location device that matches the ID.

Permissions

You can access this operation as a social user, a virtual user, an anonymous user, or a mobile user. If you access this operation as a mobile user, then you must be a member of the realm that's associated with the mobile backend.

Request

Path Parameters

  • The ID of the device to be returned. This ID must be an existing device ID.

Back to Top

Response

Supported Media Types

200 Response

The location device was retrieved successfully.
Body ()
Root Schema : Location Device
Type: object
Title: Location Device
The properties for a location device. The long format includes all properties. The short format applies to `POST /mobile/platform/location/devices` responses only.
Show Source
Nested Schema : Associated Asset
Type: object
Title: Associated Asset
The properties for an associated asset. This object doesn't include the `devices` property because the associated device is the containing object.
Show Source
Nested Schema : Attributes
Type: object
Title: Attributes
Additional Properties Allowed
Show Source
The attributes entered in the MCS UI, as key/value pairs.
Show Source
Nested Schema : Beacon
Type: object
Title: Beacon
Device's identifying information.
Match One
Show Source
Nested Schema : Associated Place
Type: object
Title: Associated Place
The properties for an associated place. This object doesn't include the `devices` property because the associated device is the containing object.
Show Source
Nested Schema : Last Known Location
Type: object
Title: Last Known Location
Last known location of the asset.
Match One
Show Source
Nested Schema : gpsPoint
Type: object
GPS point.
Show Source
Nested Schema : iBeacon
Type: object
iBeacon device.
Show Source
Nested Schema : altBeacon
Type: object
AltBeacon device.
Show Source
Nested Schema : eddystone
Type: object
Eddystone device.
Show Source
Nested Schema : eddystoneUid
Type: object
Device's UID.
Show Source
Nested Schema : eddystoneUrl
Type: object
Device's URL.
Show Source
Nested Schema : Place's Address
Type: object
Title: Place's Address
GPS address of the place.
Match One
Show Source
Nested Schema : gpsCircle
Type: object
GPS circle.
Show Source
Nested Schema : gpsPolygon
Type: object
GPS polygon.
Show Source
Nested Schema : vertices
Type: array
Minimum Number of Items: 1
GPS polygon's vertices.
Show Source
Nested Schema : latitudeLongitudePair
Type: object
Pair of latitude and longitude values for a place.
Show Source
Example Response (application/json)
{
    "id":12345,
    "createdOn":"2015-08-06T18:37:59.424Z",
    "modifiedOn":"2015-08-08T07:22:44.654Z",
    "createdBy":"jdoe",
    "modifiedBy":"tsmith",
    "description":"Beacon on 1st Floor in FixitFast Warehouse in Redwood City",
    "name":"RC_WH_01_F01_B001",
    "links":[
        {
            "rel":"canonical",
            "href":"/mobile/platform/location/devices/12345"
        },
        {
            "rel":"self",
            "href":"/mobile/platform/location/devices/12345"
        }
    ],
    "beacon":{
        "iBeacon":{
            "minor":"1.1",
            "uuid":"B9407F30-F5F8-466E-AFF9-25556B57FE6D",
            "major":"1.0"
        }
    },
    "attributes":{
        "manufacturerId":"10D39AE7-020E-4467-9CB2-DD36366F899D",
        "status":"Active",
        "visibility":"Public",
        "manufacturer":"Abc Company"
    },
    "place":{
        "id":111,
        "createdOn":"2015-08-06T18:37:59.424Z",
        "modifiedOn":"2015-08-06T18:37:59.424Z",
        "createdBy":"jdoe",
        "address":{
            "gpsPoint":{
                "longitude":-121.1566,
                "latitude":37.5548
            }
        },
        "modifiedBy":"jdoe",
        "description":"FixitFast Warehouse in Redwood City",
        "name":"FixitFast Redwood City Warehouse",
        "label":"FixitFast Warehouse",
        "links":[
            {
                "rel":"canonical",
                "href":"/mobile/platform/location/places/111"
            },
            {
                "rel":"self",
                "href":"/mobile/platform/location/places/111"
            }
        ],
        "attributes":{
            "equipmentManufacturer":"Abc Corp"
        },
        "parentPlace":42
    }
}

404 Response

Device ID not found.

Body ()
Root Schema : Error
Type: object
Title: Error
The error JSON object returned by Mobile Cloud Service.
Show Source
Nested Schema : o:errorDetails
Type: array
Minimum Number of Items: 0
List of the issues that cause the error. Included when the error is caused by multiple issues.
Show Source
Nested Schema : Error Detail
Type: object
Title: Error Detail
Show Source
Back to Top

Examples

This example shows how to use cURL to retrieve information about a device by submitting a GET request on the REST resource.

curl -i \
-X GET \ 
-u mobile.user@example.com:password \
-H "Content-Type: application/json; charset=utf-8" \
-H "Oracle-Mobile-Backend-ID: ABCD9278-091f-41aa-9cb2-184bd0586fce" \
https://fif.cloud.oracle.com/mobile/platform/location/devices/12345

Example of Response Header

Here's an example of the response header:

200 OK
Content-Length: 1084
Content-Type: application/json
Date: Tue, 16 Jun 2015 01:39:07 GMT

Example of Response Body

This example shows the contents of the response body in JSON format:

{
  "id": 12345,
  "createdOn": "2015-08-06T18:37:59.424Z",
  "createdBy": "jdoe",
  "modifiedOn": "2015-08-08T07:22:44.654Z",
  "modifiedBy": "tsmith",
  "name": "RC_WH_01_F01_B001",
  "description": "Beacon on 1st Floor in FixitFast Warehouse in Redwood City",
  "place":
  {
    "id": 111,
    "createdOn": "2015-08-06T18:37:59.424Z",
    "createdBy": "jdoe",
    "modifiedOn": "2015-08-06T18:37:59.424Z",
    "modifiedBy": "jdoe",
    "name": "FixitFast Redwood City Warehouse",
    "label": "FixitFast Warehouse",
    "parentPlace": 42,
    "description": "FixitFast Warehouse in Redwood City",
    "address" : {
      "gpsPoint" : {
        "latitude": 37.5548,
        "longitude": -121.1566
      }
    },
    "attributes" : {
      "equipmentManufacturer": "Abc Corp"
    },
    "links": [
      {
        "rel": "canonical",
        "href": "/mobile/platform/location/places/111"
      },
      {
        "rel": "self",
        "href": "/mobile/platform/location/places/111"
      }
    ]
  },
  "beacon": {
    "iBeacon" : {
      "uuid": "B9407F30-F5F8-466E-AFF9-25556B57FE6D",
      "major": "1.0",
      "minor": "1.1"
    }
  },
  "attributes" : {
    "manufacturer": "Abc Company",  
    "manufacturerId": "10D39AE7-020E-4467-9CB2-DD36366F899D"
    "status": "Active",
    "visibility": "Public"
  },
  "links": [
    {
      "rel": "canonical",
      "href": "/mobile/platform/location/devices/12345"
    },
    {
      "rel": "self",
      "href": "/mobile/platform/location/devices/12345"
    }
  ]
}
Back to Top