CampusAPI Mapping Services API documentation version 0.1.2
Based on OSID version 3.0.0
https://base.url/mapping
Overview
The Mapping service provides a means for managing inventories of places and performing a variety of mapping operations.
This package includes the following entities:
Locations
One aspect of the Mapping service provides references to location places used in other services. A Location may include a spatial coordinate or defined boundary described in a SpatialUnit. Additional queries provide a means to easily look up locations by Coordinate or arbitrary SpatialUnit as well as to traverse locations through lookups of adjacent Locations.
Locations may be structured in hierarchies to convey hierarchical relationships. A room may be located inside a building, within a city within a state.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this location, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this location, provided by system. | string(uri) |
displayName | The name of this location for display. | string |
description | The description of this location. | string |
genusTypeId (read‑only) | Id of the immutable type of this location. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this location. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
spatialUnit | The spatial unit corresponding to this location. | object(spatial-unit) |
Maps
Locations may be organuzed in hierarchical Maps that offer a means of federation or layering of map data.
Field | Description | Type |
---|---|---|
id(read‑only) | The unique id of this map, provided by system. | string(osid‑id) |
uri(read‑only) | The uri of this map, provided by system. | string(uri) |
displayName | The name of this map for display. | string |
description | The description of this map. | string |
genusTypeId (read‑only) | Id of the immutable type of this map. Default type set by system unless specified in query parameter. | string(osid‑id) |
recordTypeIds (read‑only) | Type Ids of record types available on this map. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere. | string(osid‑id)[] |
providerId | The provider of this map. References a resource.Resource object. | string(osid‑id) |
brandingIds | The branding of this map. References repository.Asset objects. | string(osid‑id)[] |
license | The licensing that applies to this map. | string |
License
CampusAPI REST Documentation Copyright 2020 DXtera Institute. Based on the Open Service Interface Defitions: http://osid.org
/locations
Collection of locations in a system, federation of systems, or in a default map.
Get all locations in the system or default map.
Create a new location in the default map.
get /locations
Get all locations in the system or default map.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleLocationType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleLocationType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleLocationType%40campusapi.org
- mapId: (string)
The id string to match a map
Example:
mapping.Map%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Location:4815@base.url",
"uri": "http://base.url/open/campusapi/mapping/location/mapping.Location%3A4815%40base.url",
"displayName": "Display Name of this Location",
"description": "The description of this Location",
"genusTypeId": "type.Type:defaultLocationType@base.url",
"recordTypeIds": [ "type.Type:exampleLocationRecordType@campusapi.org", "..."],
"spatialUnit": "..SpatialUnit.."
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /locations
Create a new location in the default map.
Query Parameters
- genusType: (string)
specify a particular location type to create
Example:
type.Type%3AexampleLocationType%40dxtera.org
- recordType: (array of )
specify support for one or more location record types
Example:
[ "type.Type%3AexampleLocationRecordType%40campusapi.org", "..." ]
- mapId: (string)
specify in which map to create this location
Example:
mapping.Map%3A8374%40base.url
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Location",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this location, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this location, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this location for display.",
"type": "string"
},
"description": {
"description": "The description of this location.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this location. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this location. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"spatialUnit": {
"description": "The spatial unit corresponding to this location.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this Location",
"description": "The description of this Location",
"spatialUnit": "..SpatialUnit.."
}
Entity representing a location form metadata.
Get form metadata for creating a new location.
get /locations/metadata
Get form metadata for creating a new location.
Query Parameters
- genusType: (string)
specify a particular location type to create
Example:
type.Type%3AexampleLocationType%40dxtera.org
- recordType: (array of )
specify support for one or more location record types
Example:
[ "type.Type%3AexampleLocationRecordType%40campusapi.org", "..." ]
- mapId: (string)
specify in which map to create this location
Example:
mapping.Map%3A8374%40base.url
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Location",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this location, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this location, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this location for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Location.Location:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this location",
"linked": false
},
"description": {
"description": "The description of this location.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Location.Location:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this location",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this location. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this location. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"spatialUnit": {
"description": "The spatial unit corresponding to this location.",
"type": "string",
"elementId": "mapping.Location:spatialUnit@dxtera.org",
"existingValue": null,
"elementLabel": "Spatial Unit",
"instructions": "NEED TO GENERATE AN INSTRUCTION FOR SPATIALUNIT.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
The root locations in the location hierarchy. A node with no parents is an orphan. While all location Ids are known to the hierarchy, an orphan does not appear in the hierarchy unless explicitly added as a root node or child of another node.
Get all root root-locations
get /locations/root-locations
Get all root root-locations
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Location:4815@base.url",
"uri": "http://base.url/open/campusapi/mapping/location/mapping.Location%3A4815%40base.url",
"displayName": "Display Name of this Location",
"description": "The description of this Location",
"genusTypeId": "type.Type:defaultLocationType@base.url",
"recordTypeIds": [ "type.Type:exampleLocationRecordType@campusapi.org", "..."],
"spatialUnit": "..SpatialUnit.."
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given location as a root in the location hierarchy
Remove the given location as a root in the location hierarchy.
put /locations/root-locations/{locationId}
Add the given location as a root in the location hierarchy
URI Parameters
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The location has been added as a root" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "location not found" }
delete /locations/root-locations/{locationId}
Remove the given location as a root in the location hierarchy.
URI Parameters
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The location has been removed as a root from the hierarchy" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "location not found" }
Entity representing a location
Get a location given its id.
Update a given location.
Delete a given location.
get /locations/{locationId}
Get a location given its id.
URI Parameters
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "mapping.Location:4815@base.url",
"uri": "http://base.url/open/campusapi/mapping/location/mapping.Location%3A4815%40base.url",
"displayName": "Display Name of this Location",
"description": "The description of this Location",
"genusTypeId": "type.Type:defaultLocationType@base.url",
"recordTypeIds": [ "type.Type:exampleLocationRecordType@campusapi.org", "..."],
"spatialUnit": "..SpatialUnit.."
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "location not found" }
put /locations/{locationId}
Update a given location.
URI Parameters
- locationId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Location",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this location, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this location, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this location for display.",
"type": "string"
},
"description": {
"description": "The description of this location.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this location. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this location. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"spatialUnit": {
"description": "The spatial unit corresponding to this location.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this Location",
"description": "The description of this Location",
"spatialUnit": "..SpatialUnit.."
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The location has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "location not found" }
delete /locations/{locationId}
Delete a given location.
URI Parameters
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The location has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "location not found" }
Entity representing a location form metadata for update
Get form metadata for updating an existing location.
get /locations/{locationId}/metadata
Get form metadata for updating an existing location.
URI Parameters
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Location",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this location, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this location, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this location for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Location.Location:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this location",
"linked": false
},
"description": {
"description": "The description of this location.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Location.Location:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this location",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this location. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this location. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"spatialUnit": {
"description": "The spatial unit corresponding to this location.",
"type": "string",
"elementId": "mapping.Location:spatialUnit@dxtera.org",
"existingValue": null,
"elementLabel": "Spatial Unit",
"instructions": "NEED TO GENERATE AN INSTRUCTION FOR SPATIALUNIT.",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "location not found" }
Get child locations for the given location in the hierarchy.
get /locations/{locationId}/children
Get child locations for the given location in the hierarchy.
URI Parameters
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Location:4815@base.url",
"uri": "http://base.url/open/campusapi/mapping/location/mapping.Location%3A4815%40base.url",
"displayName": "Display Name of this Location",
"description": "The description of this Location",
"genusTypeId": "type.Type:defaultLocationType@base.url",
"recordTypeIds": [ "type.Type:exampleLocationRecordType@campusapi.org", "..."],
"spatialUnit": "..SpatialUnit.."
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add location as child of the given location in the hierarchy.
Remove the given location as a child of the given location in the hierarchy.
put /locations/{locationId}/children/{childId}
Add location as child of the given location in the hierarchy.
URI Parameters
- locationId: required(string)
- childId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The child location has been added to the hierarchy" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "location not found" }
delete /locations/{locationId}/children/{childId}
Remove the given location as a child of the given location in the hierarchy.
URI Parameters
- locationId: required(string)
- childId: required(string)
Get parent locations for the given location in the hierarchy.
get /locations/{locationId}/parents
Get parent locations for the given location in the hierarchy.
URI Parameters
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Location:4815@base.url",
"uri": "http://base.url/open/campusapi/mapping/location/mapping.Location%3A4815%40base.url",
"displayName": "Display Name of this Location",
"description": "The description of this Location",
"genusTypeId": "type.Type:defaultLocationType@base.url",
"recordTypeIds": [ "type.Type:exampleLocationRecordType@campusapi.org", "..."],
"spatialUnit": "..SpatialUnit.."
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
/maps
Collection of maps in a system or federation of systems.
Get all maps.
Create a new map.
get /maps
Get all maps.
Query Parameters
- offset: (integer - default: 0)
Skip over a number of elements by specifying an offset value for the query
Example:
20
- limit: (integer - default: 10)
Limit the number of elements on the response
Example:
80
- genusTypeId: (string)
The id string to match a genusType
Example:
type.Type%3AexampleMapType%40dxtera.org
- parentGenusTypeId: (string)
The id string to match a parent genusType
Example:
type.Type%3AparentTypeExampleMapType%40dxtera.org
- recordTypeId: (string)
The id string to match a recordType
Example:
type.Type%3AexampleMapType%40campusapi.org
- providerId: (string)
Id string to match provider.
Example:
resource.Resource%3A3007%40demo.dxtera.org
- locationId: (string)
Get maps mapped to this location.
Example:
mapping.Location%3A168%40demo.dxtera.org
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Map:3545@base.url",
"uri": "http://base.url/open/campusapi/mapping/map/mapping.Map%3A3545%40base.url",
"displayName": "Display Name of this Map",
"description": "The description of this Map",
"genusTypeId": "type.Type:defaultMapType@base.url",
"recordTypeIds": [ "type.Type:exampleMapRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Map@base.url",
"license": "The license that applies to this Map"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
post /maps
Create a new map.
Query Parameters
- genusType: (string)
specify a particular map type to create
Example:
type.Type%3AexampleMapType%40dxtera.org
- recordType: (array of )
specify support for one or more map record types
Example:
[ "type.Type%3AexampleMapRecordType%40campusapi.org", "..." ]
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Map",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this map, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this map, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this map for display.",
"type": "string"
},
"description": {
"description": "The description of this map.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this map. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this map. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this map.",
"type": "string",
"format": "osid-id"
},
"brandingIds": {
"description": "The branding of this map. A collection of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id"
}
},
"license": {
"description": "The licensing that applies to this map.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this Map",
"description": "The description of this Map",
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Map@base.url",
"license": "The license that applies to this Map"
}
Entity representing a map form metadata.
Get form metadata for creating a new map.
get /maps/metadata
Get form metadata for creating a new map.
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Map",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this map, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this map, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this map for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Map.Map:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this map",
"linked": false
},
"description": {
"description": "The description of this map.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Map.Map:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this map",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this map. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this map. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this map.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Map.Map:provider@base.url",
"existingValue": "",
"elementLabel": "Provider",
"instructions": "Enter the provider of this map",
"linked": false
},
"brandingIds": {
"description": "The branding of this map. A list of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"default": [],
"elementId": "Map.Map:branding@base.url",
"existingValue": "",
"elementLabel": "Branding",
"instructions": "Enter the branding images for this map",
"linked": false
},
"license": {
"description": "The licensing that applies to this map.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Map.Map:license@base.url",
"existingValue": "The Existing License",
"elementLabel": "License",
"instructions": "Include a license for this map",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
The root maps in the map hierarchy. A node with no parents is an orphan. While all map Ids are known to the hierarchy, an orphan does not appear in the hierarchy unless explicitly added as a root node or child of another node.
Get all root root-map
get /maps/root-map
Get all root root-map
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Map:3545@base.url",
"uri": "http://base.url/open/campusapi/mapping/map/mapping.Map%3A3545%40base.url",
"displayName": "Display Name of this Map",
"description": "The description of this Map",
"genusTypeId": "type.Type:defaultMapType@base.url",
"recordTypeIds": [ "type.Type:exampleMapRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Map@base.url",
"license": "The license that applies to this Map"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Entity representing a map
Get a map given its id.
Update a given map.
Delete a given map.
get /maps/{mapId}
Get a map given its id.
URI Parameters
- mapId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"id": "mapping.Map:3545@base.url",
"uri": "http://base.url/open/campusapi/mapping/map/mapping.Map%3A3545%40base.url",
"displayName": "Display Name of this Map",
"description": "The description of this Map",
"genusTypeId": "type.Type:defaultMapType@base.url",
"recordTypeIds": [ "type.Type:exampleMapRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Map@base.url",
"license": "The license that applies to this Map"
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "map not found" }
put /maps/{mapId}
Update a given map.
URI Parameters
- mapId: required(string)
Body
Media type: application/json
Type: json
Content:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Map",
"type": "object",
"properties": {
"id": {
"description": "The unique id of this map, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this map, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this map for display.",
"type": "string"
},
"description": {
"description": "The description of this map.",
"type": "string"
},
"genusTypeId": {
"description": "Id of the immutable type of this map. Default type set by system unless specified in query parameter.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this map. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this map.",
"type": "string",
"format": "osid-id"
},
"brandingIds": {
"description": "The branding of this map. A collection of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id"
}
},
"license": {
"description": "The licensing that applies to this map.",
"type": "string"
}
}
}
Example:
{
"displayName": "Display Name of this Map",
"description": "The description of this Map",
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Map@base.url",
"license": "The license that applies to this Map"
}
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The map has been updated" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "map not found" }
delete /maps/{mapId}
Delete a given map.
URI Parameters
- mapId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The map has been deleted" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "map not found" }
Entity representing a map form metadata for update
Get form metadata for updating an existing map.
get /maps/{mapId}/metadata
Get form metadata for updating an existing map.
URI Parameters
- mapId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{
"$schema": "http://json-schema.org/draft/2019-9/schema#",
"title": "Map",
"type": "object",
"required": ["displayName"],
"properties": {
"id": {
"description": "The unique id of this map, provided by system.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"uri": {
"description": "The uri of this map, provided by system.",
"type": "string",
"format": "uri",
"readOnly": true
},
"displayName": {
"description": "The name of this map for display.",
"type": "string",
"read-only": false,
"minLength": 1,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Map.Map:displayName@base.url",
"existingValue": "The Existing Name",
"elementLabel": "Name",
"instructions": "Enter a name for this map",
"linked": false
},
"description": {
"description": "The description of this map.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Map.Map:displayName@demo.base.url",
"existingValue": "The Existing Description",
"elementLabel": "Description",
"instructions": "Enter a description for this map",
"linked": false
},
"genusTypeId": {
"description": "Id of the immutable type of this map. Default type set by system unless specified in query parameter on initial post.",
"type": "string",
"format": "osid-id",
"readOnly": true
},
"recordTypeIds": {
"description": "Type Ids of record types available on this map. Record types define special attributes available on an object to support specific applications or classes of applications and are documented elsewhere.",
"type": "array",
"items": {
"type": "string",
"format": "osid-id"
},
"readOnly": true
},
"providerId": {
"description": "The provider of this map.",
"type": "string",
"format": "osid-id",
"read-only": false,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Map.Map:provider@base.url",
"existingValue": "",
"elementLabel": "Provider",
"instructions": "Enter the provider of this map",
"linked": false
},
"brandingIds": {
"description": "The branding of this map. A list of Assets.",
"type": "array",
"items" : {
"type": "string",
"format": "osid-id",
"pattern": "",
"enum": []
},
"read-only": false,
"default": [],
"elementId": "Map.Map:branding@base.url",
"existingValue": "",
"elementLabel": "Branding",
"instructions": "Enter the branding images for this map",
"linked": false
},
"license": {
"description": "The licensing that applies to this map.",
"type": "string",
"read-only": false,
"minLength": 0,
"maxLength": 128,
"pattern": "",
"default": "",
"enum": [],
"elementId": "Map.Map:license@base.url",
"existingValue": "The Existing License",
"elementLabel": "License",
"instructions": "Include a license for this map",
"linked": false
}
}
}
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{"message": "map not found" }
Get child maps for the given map in the hierarchy.
get /maps/{mapId}/children
Get child maps for the given map in the hierarchy.
URI Parameters
- mapId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Map:3545@base.url",
"uri": "http://base.url/open/campusapi/mapping/map/mapping.Map%3A3545%40base.url",
"displayName": "Display Name of this Map",
"description": "The description of this Map",
"genusTypeId": "type.Type:defaultMapType@base.url",
"recordTypeIds": [ "type.Type:exampleMapRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Map@base.url",
"license": "The license that applies to this Map"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add map as child of the given map in the hierarchy.
Remove the given map as a child of the given map in the hierarchy.
put /maps/{mapId}/children/{childId}
Add map as child of the given map in the hierarchy.
URI Parameters
- mapId: required(string)
- childId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "The child map has been added to the hierarchy" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "map not found" }
delete /maps/{mapId}/children/{childId}
Remove the given map as a child of the given map in the hierarchy.
URI Parameters
- mapId: required(string)
- childId: required(string)
Get parent maps for the given map in the hierarchy.
get /maps/{mapId}/parents
Get parent maps for the given map in the hierarchy.
URI Parameters
- mapId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Map:3545@base.url",
"uri": "http://base.url/open/campusapi/mapping/map/mapping.Map%3A3545%40base.url",
"displayName": "Display Name of this Map",
"description": "The description of this Map",
"genusTypeId": "type.Type:defaultMapType@base.url",
"recordTypeIds": [ "type.Type:exampleMapRecordType@campusapi.org", "..."],
"providerId": "resource.Resource:123@base.url",
"brandingId": "asset.Asset:Map@base.url",
"license": "The license that applies to this Map"
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Get all locations in this map
get /maps/{mapId}/locations
Get all locations in this map
URI Parameters
- mapId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
[
{
"id": "mapping.Location:4815@base.url",
"uri": "http://base.url/open/campusapi/mapping/location/mapping.Location%3A4815%40base.url",
"displayName": "Display Name of this Location",
"description": "The description of this Location",
"genusTypeId": "type.Type:defaultLocationType@base.url",
"recordTypeIds": [ "type.Type:exampleLocationRecordType@campusapi.org", "..."],
"spatialUnit": "..SpatialUnit.."
},
{
"...": "..."
}
]
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
Add the given location to this map
Remove the given location from the map.
put /maps/{mapId}/locations/{locationId}
Add the given location to this map
URI Parameters
- mapId: required(string)
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "location has been added to map" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "location not found" }
delete /maps/{mapId}/locations/{locationId}
Remove the given location from the map.
URI Parameters
- mapId: required(string)
- locationId: required(string)
HTTP status code 200
Body
Media type: application/json
Type: any
Example:
{ "message": "location has been removed" }
HTTP status code 403
Body
Media type: application/json
Type: any
Example:
{"message": "Permission denied" }
HTTP status code 404
Body
Media type: application/json
Type: any
Example:
{ "message": "location not found" }