Add Places

post

/mobile/system/locationManagement/places

Creates one or more location places.

Permissions

Only team members with the Administrator role can access the Location Management API.

Request

Supported Media Types

• application/json

Body ()

Root Schema : Place Items Array

Type: object

Title: Place Items Array

Show Source

• items: array items
  Minimum Number of Items: 1

  Array of the places to be created.

{
    "title":"Place Items Array",
    "type":"object",
    "properties":{
        "items":{
            "minItems":1,
            "description":"Array of the places to be created.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/createPlace"
            }
        }
    }
}

Nested Schema : items

Type: array

Minimum Number of Items: 1

Array of the places to be created.

Show Source

• [0]: object Create Place
  Title: Create Place

  The place to be created.

{
    "minItems":1,
    "description":"Array of the places to be created.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/createPlace"
    }
}

Nested Schema : Create Place

Type: object

Title: Create Place

The place to be created.

Show Source

• address: object Place's Address
  Title: Place's Address

  GPS address of the place.
• attributes: object Attributes
  Title: Attributes

  Additional Properties Allowed: additionalProperties

  The attributes entered in the UI, as key/value pairs.
• description: string
  Place's description.
• devices: array devices
  Minimum Number of Items: 0

  IDs of devices that are associated with this place. Typically one device, but there can be multiple devices.
• label: string
  Place's label.
• name: string
  User-defined name for the place. Must be unique.
• parentPlace: number
  Place ID of the place's parent.

{
    "description":"The place to be created.",
    "title":"Create Place",
    "type":"object",
    "required":[
        "name"
    ],
    "properties":{
        "address":{
            "$ref":"#/definitions/placeAddress"
        },
        "devices":{
            "minItems":0,
            "description":"IDs of devices that are associated with this place. Typically one device, but there can be multiple devices.",
            "type":"array",
            "items":{
                "type":"integer"
            }
        },
        "parentPlace":{
            "description":"Place ID of the place's parent.",
            "type":"number"
        },
        "name":{
            "description":"User-defined name for the place. Must be unique.",
            "type":"string"
        },
        "description":{
            "description":"Place's description.",
            "type":"string"
        },
        "attributes":{
            "$ref":"#/definitions/objectAttributes"
        },
        "label":{
            "description":"Place's label.",
            "type":"string"
        }
    }
}

Nested Schema : Place's Address

Type: object

Title: Place's Address

GPS address of the place.

Match One

Show Source

• object gpsPoint
  GPS point.
• object gpsCircle
  GPS circle.
• object gpsPolygon
  GPS polygon.

{
    "description":"GPS address of the place.",
    "title":"Place's Address",
    "type":"object",
    "x-oneOf":[
        {
            "$ref":"#/definitions/gpsPoint"
        },
        {
            "$ref":"#/definitions/gpsCircle"
        },
        {
            "$ref":"#/definitions/gpsPolygon"
        }
    ]
}

Nested Schema : Attributes

Type: object

Title: Attributes

Additional Properties Allowed

Show Source

• string

{
    "description":"The attributes entered in the UI, as key/value pairs.",
    "additionalProperties":{
        "type":"string"
    },
    "title":"Attributes",
    "type":"object",
    "properties":{
    }
}

The attributes entered in the UI, as key/value pairs.

Show Source

{
    "description":"The attributes entered in the UI, as key/value pairs.",
    "additionalProperties":{
        "type":"string"
    },
    "title":"Attributes",
    "type":"object",
    "properties":{
    }
}

Nested Schema : devices

Type: array

Minimum Number of Items: 0

IDs of devices that are associated with this place. Typically one device, but there can be multiple devices.

Show Source

• [0]: integer

{
    "minItems":0,
    "description":"IDs of devices that are associated with this place. Typically one device, but there can be multiple devices.",
    "type":"array",
    "items":{
        "type":"integer"
    }
}

Nested Schema : gpsPoint

Type: object

GPS point.

Show Source

• latitude: number
  GPS point's latitude
• longitude: number
  GPS point's longitude.

{
    "description":"GPS point.",
    "type":"object",
    "properties":{
        "latitude":{
            "description":"GPS point's latitude",
            "type":"number"
        },
        "longitude":{
            "description":"GPS point's longitude.",
            "type":"number"
        }
    }
}

Nested Schema : gpsCircle

Type: object

GPS circle.

Show Source

• latitude: number
  Latitude of the center of the GPS circle.
• longitude: number
  Longitude of the center of the GPS circle.
• radius: number
  GPS circle's radius in meters.

{
    "description":"GPS circle.",
    "type":"object",
    "properties":{
        "latitude":{
            "description":"Latitude of the center of the GPS circle.",
            "type":"number"
        },
        "radius":{
            "description":"GPS circle's radius in meters.",
            "type":"number"
        },
        "longitude":{
            "description":"Longitude of the center of the GPS circle.",
            "type":"number"
        }
    }
}

Nested Schema : gpsPolygon

Type: object

GPS polygon.

Show Source

• vertices: array vertices
  Minimum Number of Items: 1

  GPS polygon's vertices.

{
    "description":"GPS polygon.",
    "type":"object",
    "properties":{
        "vertices":{
            "minItems":1,
            "description":"GPS polygon's vertices.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/latitudeLongitudePair"
            }
        }
    }
}

Nested Schema : vertices

Type: array

Minimum Number of Items: 1

GPS polygon's vertices.

Show Source

• [0]: object latitudeLongitudePair
  Pair of latitude and longitude values for a place.

{
    "minItems":1,
    "description":"GPS polygon's vertices.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/latitudeLongitudePair"
    }
}

Nested Schema : latitudeLongitudePair

Type: object

Pair of latitude and longitude values for a place.

Show Source

• latitude: number
  Place's latitude.
• longitude: number
  Place's longitude.

{
    "description":"Pair of latitude and longitude values for a place.",
    "type":"object",
    "properties":{
        "latitude":{
            "description":"Place's latitude.",
            "type":"number"
        },
        "longitude":{
            "description":"Place's longitude.",
            "type":"number"
        }
    }
}

Example Request (application/json)

{
    "items":[
        {
            "address":{
                "gpsPoint":{
                    "latitude":37,
                    "longitude":122
                }
            },
            "devices":[
                12345
            ],
            "parentPlace":42,
            "name":"FixItFast Redwood City Warehouse",
            "description":"FixItFast Warehouse in Redwood City",
            "attributes":{
                "hours":"9am-6pm"
            },
            "label":"FixItFast Warehouse"
        }
    ]
}

Response

Supported Media Types

• application/json

200 Response

The location places were created successfully.

Body ()

Root Schema : Place Items Array

Type: object

Title: Place Items Array

Show Source

• items: array items
  Minimum Number of Items: 1

  Array of the created places.

{
    "title":"Place Items Array",
    "type":"object",
    "properties":{
        "items":{
            "minItems":1,
            "description":"Array of the created places.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/returnPlace"
            }
        }
    }
}

Nested Schema : items

Type: array

Minimum Number of Items: 1

Array of the created places.

Show Source

• [0]: object Place
  Title: Place

  The created or updated place.

{
    "minItems":1,
    "description":"Array of the created places.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/returnPlace"
    }
}

Nested Schema : Place

Type: object

Title: Place

The created or updated place.

Show Source

• address: object Place's Address
  Title: Place's Address

  GPS address of the place.
• attributes: object Attributes
  Title: Attributes

  Additional Properties Allowed: additionalProperties

  The attributes entered in the UI, as key/value pairs.
• children: array children
  Minimum Number of Items: 0

  Places that are the child places of this place. This includes the full hierarchy of places that descend from this place.
• createdBy: string
  User who added the place.
• createdOn: string
  When the place was added.
• description: string
  Place's description.
• devices: array devices
  Minimum Number of Items: 0

  Devices associated with this place. Typically one device, but there can be multiple devices.
• hasChildren: boolean
  Set to `true` if this place is a parent of other places.
• id: number
  Place's ID.
• label: string
  Place's label.
• links: array Relationship links
  Title: Relationship links

  Minimum Number of Items: 1

  Unique Items Required: true
• modifiedBy: string
  User who last modified the place.
• modifiedOn: string
  When the place was last modified.
• name: string
  User-defined name for the place.
• parentPlace: number
  Place ID of the place's parent.

{
    "description":"The created or updated place.",
    "title":"Place",
    "type":"object",
    "required":[
        "id",
        "createdOn",
        "createdBy",
        "name",
        "description",
        "links"
    ],
    "properties":{
        "address":{
            "$ref":"#/definitions/placeAddress"
        },
        "devices":{
            "minItems":0,
            "description":"Devices associated with this place. Typically one device, but there can be multiple devices.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/associatedDevice"
            }
        },
        "hasChildren":{
            "description":"Set to `true` if this place is a parent of other places.",
            "type":"boolean"
        },
        "description":{
            "description":"Place's description.",
            "type":"string"
        },
        "label":{
            "description":"Place's label.",
            "type":"string"
        },
        "createdOn":{
            "description":"When the place was added.",
            "type":"string"
        },
        "modifiedOn":{
            "description":"When the place was last modified.",
            "type":"string"
        },
        "children":{
            "minItems":0,
            "description":"Places that are the child places of this place. This includes the full hierarchy of places that descend from this place.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/returnPlace"
            }
        },
        "createdBy":{
            "description":"User who added the place.",
            "type":"string"
        },
        "parentPlace":{
            "description":"Place ID of the place's parent.",
            "type":"number"
        },
        "name":{
            "description":"User-defined name for the place.",
            "type":"string"
        },
        "modifiedBy":{
            "description":"User who last modified the place.",
            "type":"string"
        },
        "links":{
            "$ref":"#/definitions/links"
        },
        "attributes":{
            "$ref":"#/definitions/objectAttributes"
        },
        "id":{
            "description":"Place's ID.",
            "type":"number"
        }
    }
}

Nested Schema : Place's Address

Type: object

Title: Place's Address

GPS address of the place.

Match One

Show Source

• object gpsPoint
  GPS point.
• object gpsCircle
  GPS circle.
• object gpsPolygon
  GPS polygon.

{
    "description":"GPS address of the place.",
    "title":"Place's Address",
    "type":"object",
    "x-oneOf":[
        {
            "$ref":"#/definitions/gpsPoint"
        },
        {
            "$ref":"#/definitions/gpsCircle"
        },
        {
            "$ref":"#/definitions/gpsPolygon"
        }
    ]
}

Nested Schema : Attributes

Type: object

Title: Attributes

Additional Properties Allowed

Show Source

• string

{
    "description":"The attributes entered in the UI, as key/value pairs.",
    "additionalProperties":{
        "type":"string"
    },
    "title":"Attributes",
    "type":"object",
    "properties":{
    }
}

The attributes entered in the UI, as key/value pairs.

Show Source

{
    "description":"The attributes entered in the UI, as key/value pairs.",
    "additionalProperties":{
        "type":"string"
    },
    "title":"Attributes",
    "type":"object",
    "properties":{
    }
}

Nested Schema : children

Type: array

Minimum Number of Items: 0

Places that are the child places of this place. This includes the full hierarchy of places that descend from this place.

Show Source

• [0]: object Place
  Title: Place

  The created or updated place.

{
    "minItems":0,
    "description":"Places that are the child places of this place. This includes the full hierarchy of places that descend from this place.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/returnPlace"
    }
}

Nested Schema : devices

Type: array

Minimum Number of Items: 0

Devices associated with this place. Typically one device, but there can be multiple devices.

Show Source

• [0]: object Associated Location Device
  Title: Associated Location Device

  The properties for an associated location device. Note that this object doesn't contain the `asset` and `place` properties.

{
    "minItems":0,
    "description":"Devices associated with this place. Typically one device, but there can be multiple devices.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/associatedDevice"
    }
}

Nested Schema : Relationship links

Type: array

Title: Relationship links

Minimum Number of Items: 1

Unique Items Required: true

Show Source

• [0]: object Link
  Title: Link

{
    "minItems":1,
    "uniqueItems":true,
    "title":"Relationship links",
    "type":"array",
    "items":{
        "$ref":"#/definitions/link"
    }
}

Nested Schema : gpsPoint

Type: object

GPS point.

Show Source

• latitude: number
  GPS point's latitude
• longitude: number
  GPS point's longitude.

{
    "description":"GPS point.",
    "type":"object",
    "properties":{
        "latitude":{
            "description":"GPS point's latitude",
            "type":"number"
        },
        "longitude":{
            "description":"GPS point's longitude.",
            "type":"number"
        }
    }
}

Nested Schema : gpsCircle

Type: object

GPS circle.

Show Source

• latitude: number
  Latitude of the center of the GPS circle.
• longitude: number
  Longitude of the center of the GPS circle.
• radius: number
  GPS circle's radius in meters.

{
    "description":"GPS circle.",
    "type":"object",
    "properties":{
        "latitude":{
            "description":"Latitude of the center of the GPS circle.",
            "type":"number"
        },
        "radius":{
            "description":"GPS circle's radius in meters.",
            "type":"number"
        },
        "longitude":{
            "description":"Longitude of the center of the GPS circle.",
            "type":"number"
        }
    }
}

Nested Schema : gpsPolygon

Type: object

GPS polygon.

Show Source

• vertices: array vertices
  Minimum Number of Items: 1

  GPS polygon's vertices.

{
    "description":"GPS polygon.",
    "type":"object",
    "properties":{
        "vertices":{
            "minItems":1,
            "description":"GPS polygon's vertices.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/latitudeLongitudePair"
            }
        }
    }
}

Nested Schema : vertices

Type: array

Minimum Number of Items: 1

GPS polygon's vertices.

Show Source

• [0]: object latitudeLongitudePair
  Pair of latitude and longitude values for a place.

{
    "minItems":1,
    "description":"GPS polygon's vertices.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/latitudeLongitudePair"
    }
}

Nested Schema : latitudeLongitudePair

Type: object

Pair of latitude and longitude values for a place.

Show Source

• latitude: number
  Place's latitude.
• longitude: number
  Place's longitude.

{
    "description":"Pair of latitude and longitude values for a place.",
    "type":"object",
    "properties":{
        "latitude":{
            "description":"Place's latitude.",
            "type":"number"
        },
        "longitude":{
            "description":"Place's longitude.",
            "type":"number"
        }
    }
}

Nested Schema : Associated Location Device

Type: object

Title: Associated Location Device

The properties for an associated location device. Note that this object doesn't contain the `asset` and `place` properties.

Show Source

• attributes: object Attributes
  Title: Attributes

  Additional Properties Allowed: additionalProperties

  The attributes entered in the UI, as key/value pairs.
• beacon: object Beacon
  Title: Beacon

  Device's identifying information.
• createdBy: string
  User who added the device.
• createdOn: string
  When the device was added.
• description: string
  Device's description.
• id: number
  Device's ID.
• links: array Relationship links
  Title: Relationship links

  Minimum Number of Items: 1

  Unique Items Required: true
• modifiedBy: string
  User who last modified the device.
• modifiedOn: string
  When the device was last modified.
• name: string
  User-defined name for the device.

{
    "description":"The properties for an associated location device. Note that this object doesn't contain the `asset` and `place` properties.",
    "title":"Associated Location Device",
    "type":"object",
    "required":[
        "id",
        "createdOn",
        "createdBy",
        "name",
        "description",
        "links"
    ],
    "properties":{
        "modifiedOn":{
            "description":"When the device was last modified.",
            "type":"string"
        },
        "beacon":{
            "$ref":"#/definitions/beacon"
        },
        "createdBy":{
            "description":"User who added the device.",
            "type":"string"
        },
        "name":{
            "description":"User-defined name for the device.",
            "type":"string"
        },
        "description":{
            "description":"Device's description.",
            "type":"string"
        },
        "modifiedBy":{
            "description":"User who last modified the device.",
            "type":"string"
        },
        "links":{
            "$ref":"#/definitions/links"
        },
        "attributes":{
            "$ref":"#/definitions/objectAttributes"
        },
        "id":{
            "description":"Device's ID.",
            "type":"number"
        },
        "createdOn":{
            "description":"When the device was added.",
            "type":"string"
        }
    }
}

Nested Schema : Beacon

Type: object

Title: Beacon

Device's identifying information.

Match One

Show Source

• object iBeacon
  iBeacon device.
• object altBeacon
  AltBeacon device.
• object eddystone
  Eddystone device.

{
    "description":"Device's identifying information.",
    "title":"Beacon",
    "type":"object",
    "x-oneOf":[
        {
            "$ref":"#/definitions/iBeacon"
        },
        {
            "$ref":"#/definitions/altBeacon"
        },
        {
            "$ref":"#/definitions/eddystone"
        }
    ]
}

Nested Schema : iBeacon

Type: object

iBeacon device.

Show Source

• major: string
  Device's major version number.
• minor: string
  Device's minor version number.
• uuid: string
  Device's UUID.

{
    "description":"iBeacon device.",
    "type":"object",
    "properties":{
        "major":{
            "description":"Device's major version number.",
            "type":"string"
        },
        "minor":{
            "description":"Device's minor version number.",
            "type":"string"
        },
        "uuid":{
            "description":"Device's UUID.",
            "type":"string"
        }
    }
}

Nested Schema : altBeacon

Type: object

AltBeacon device.

Show Source

• id1: string
  Device's first ID.
• id2: string
  Device's second ID.
• id3: string
  Device's third ID.

{
    "description":"AltBeacon device.",
    "type":"object",
    "properties":{
        "id2":{
            "description":"Device's second ID.",
            "type":"string"
        },
        "id1":{
            "description":"Device's first ID.",
            "type":"string"
        },
        "id3":{
            "description":"Device's third ID.",
            "type":"string"
        }
    }
}

Nested Schema : eddystone

Type: object

Eddystone device.

Show Source

• eddystoneUid: object eddystoneUid
  Device's UID.
• eddystoneUrl: object eddystoneUrl
  Device's URL.

{
    "description":"Eddystone device.",
    "type":"object",
    "properties":{
        "eddystoneUid":{
            "description":"Device's UID.",
            "type":"object",
            "properties":{
                "instance":{
                    "description":"Individual device's ID.",
                    "type":"string"
                },
                "namespace":{
                    "description":"Namespace that the device is a member of.",
                    "type":"string"
                }
            }
        },
        "eddystoneUrl":{
            "description":"Device's URL.",
            "type":"object",
            "properties":{
                "url":{
                    "description":"The URL.",
                    "type":"string"
                }
            }
        }
    }
}

Nested Schema : eddystoneUid

Type: object

Device's UID.

Show Source

• instance: string
  Individual device's ID.
• namespace: string
  Namespace that the device is a member of.

{
    "description":"Device's UID.",
    "type":"object",
    "properties":{
        "instance":{
            "description":"Individual device's ID.",
            "type":"string"
        },
        "namespace":{
            "description":"Namespace that the device is a member of.",
            "type":"string"
        }
    }
}

Nested Schema : eddystoneUrl

Type: object

Device's URL.

Show Source

• url: string
  The URL.

{
    "description":"Device's URL.",
    "type":"object",
    "properties":{
        "url":{
            "description":"The URL.",
            "type":"string"
        }
    }
}

Nested Schema : Link

Type: object

Title: Link

Show Source

• href: string
  A relative URL.
• rel:
  Allowed Values: [ "self", "canonical", "prev", "next" ]

  The type of link.

{
    "title":"Link",
    "type":"object",
    "required":[
        "rel",
        "href"
    ],
    "properties":{
        "rel":{
            "description":"The type of link.",
            "enum":[
                "self",
                "canonical",
                "prev",
                "next"
            ]
        },
        "href":{
            "description":"A relative URL.",
            "type":"string"
        }
    }
}

Example Response (application/json)

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

400 Response

Bad request.

Body ()

Root Schema : Error

Type: object

Title: Error

The error JSON object returned by the service.

Show Source

• detail: string
  Message that provides the error details.
• o:ecid: string
  Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
• o:errorCode: string
  The service's error code.
• o:errorDetails: array o:errorDetails
  Minimum Number of Items: 0

  List of the issues that cause the error. Included when the error is caused by multiple issues.
• o:errorPath: string
  The relative point in the API path where the error occurred.
• status: integer
  HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
• title: string
  Summary of the problem.
• type: string
  The URI to the link that provides details about the HTTP status code.

{
    "description":"The error JSON object returned by the service.",
    "title":"Error",
    "type":"object",
    "required":[
        "type",
        "status",
        "title",
        "detail",
        "o:ecid",
        "o:errorCode",
        "o:errorPath"
    ],
    "properties":{
        "o:errorCode":{
            "description":"The service's error code.",
            "type":"string"
        },
        "o:errorDetails":{
            "minItems":0,
            "description":"List of the issues that cause the error. Included when the error is caused by multiple issues.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/errorDetail"
            }
        },
        "detail":{
            "description":"Message that provides the error details.",
            "type":"string"
        },
        "type":{
            "description":"The URI to the link that provides details about the HTTP status code.",
            "type":"string"
        },
        "title":{
            "description":"Summary of the problem.",
            "type":"string"
        },
        "o:errorPath":{
            "description":"The relative point in the API path where the error occurred.",
            "type":"string"
        },
        "o:ecid":{
            "description":"Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.",
            "type":"string"
        },
        "status":{
            "description":"HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.",
            "type":"integer"
        }
    }
}

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

• [0]: object Error Detail
  Title: Error Detail

{
    "minItems":0,
    "description":"List of the issues that cause the error. Included when the error is caused by multiple issues.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/errorDetail"
    }
}

Nested Schema : Error Detail

Type: object

Title: Error Detail

Show Source

• instance: string
  The URI to the link that provides more detailed information about the error.
• o:errorCode: string
  The service's error code.
• o:errorPath: string
  The relative point in the API path where the error occurred.
• title: string
  Summary of the problem.
• type: string
  The URI to the link that provides details about the HTTP status code.

{
    "title":"Error Detail",
    "type":"object",
    "required":[
        "type",
        "instance",
        "title",
        "o:errorPath",
        "o:errorCode"
    ],
    "properties":{
        "instance":{
            "description":"The URI to the link that provides more detailed information about the error.",
            "type":"string"
        },
        "o:errorCode":{
            "description":"The service's error code.",
            "type":"string"
        },
        "type":{
            "description":"The URI to the link that provides details about the HTTP status code.",
            "type":"string"
        },
        "title":{
            "description":"Summary of the problem.",
            "type":"string"
        },
        "o:errorPath":{
            "description":"The relative point in the API path where the error occurred.",
            "type":"string"
        }
    }
}

Examples

The following example shows how to create places by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL.

curl -i
-X POST 
-u [e-mail]:password
-d @places.json
-H "Content-Type: application/json; charset=utf-8"
-H "Oracle-Mobile-Backend-ID: ABCD9278-091f-41aa-9cb2-184bd0586fce"
http://fif.cloud.oracle.com/mobile/system/locationManagement/places

Examples of Request Body

The following shows an example of the request body.

{
  "items": [
        {
            "name": "l1b1",
            "label": "lot 1 block 1",
            "description": "Lot 1 block 1 New City",
            "address" : {
                "gpsCircle" : {
                    "latitude": 37.9856,
                    "longitude": -120.8745,
                    "radius": 30000
                }
            },
            "properties" : {
                "acres": ".25"
            }
            
        },
        {
            "name": "l2b1",
            "label": "lot2 block 1",
            "description": "Lot 2 block 1 New City",
            "address" : {
                "gpsPolygon" : {
                    "vertices": [
                        {
                            "latitude": 37.8453,
                            "longitude": -121.7845
                        },
                        {
                            "latitude": 37.1248,
                            "longitude": -120.9853
                        },
                        {
                            "latitude": 37.6983,
                            "longitude": -121.7758
                        }
                     ]
                }
            },
            "properties" : {
                "acres": ".25"
            }
            
        }
    ]
}

Example of Response Header

The following shows an example of the response header:

200 OK
Content-Length: 1045
Content-Type: application/json
Date: Tue, 19 Sep 2017 21:48:18 GMT

Example of Response Body

The following example shows the contents of the response body in JSON format:

{
    "items": [
        {
            "id": 30,
            "createdOn": "2017-09-19T23:14:50.300Z",
            "createdBy": "administrator",
            "modifiedOn": "2017-09-19T23:14:50.300Z",
            "modifiedBy": "administrator",
            "name": "l1b1",
            "label": "lot 1 block 1",
            "description": "Lot 1 block 1 New City",
            "hasChildren": false,
            "address": {
                "gpsCircle": {
                    "longitude": -120.8745,
                    "latitude": 37.9856,
                    "radius": 30000
                }
            },
            "attributes": {
                "acres": ".25"
            },
            "links": [
                {
                    "rel": "canonical",
                    "href": "/mobile/platform/location/places/30"
                },
                {
                    "rel": "self",
                    "href": "/mobile/platform/location/places/30"
                }
            ]
        },
        {
            "id": 31,
            "createdOn": "2017-09-19T23:14:50.316Z",
            "createdBy": "uimcs",
            "modifiedOn": "2017-09-19T23:14:50.316Z",
            "modifiedBy": "uimcs",
            "name": "l2b1",
            "label": "lot2 block 1",
            "description": "Lot 2 block 1 New City",
            "hasChildren": false,
            "address": {
                "gpsPolygon": {
                    "vertices": [
                        {
                            "longitude": -121.7845,
                            "latitude": 37.8453
                        },
                        {
                            "longitude": -120.9853,
                            "latitude": 37.1248
                        },
                        {
                            "longitude": -121.7758,
                            "latitude": 37.6983
                        }
                    ]
                }
            },
            "attributes": {
                "acres": ".25"
            },
            "links": [
                {
                    "rel": "canonical",
                    "href": "/mobile/platform/location/places/31"
                },
                {
                    "rel": "self",
                    "href": "/mobile/platform/location/places/31"
                }
            ]
        }
    ]
}