URI
<3D_uri>/datas[.<format>]
Supported methods
Parent resource
Child resources
Introduction
The datas resource represents a set of all 3D datasets. It can be used to retrieve information about all the 3D datasets in the current 3D service.
Please refer to the development guide for more information about this resource usage: Get image cache data.
Supported methods
- GET: Gets a list of all 3D datasets.
- HEAD: Gets the metadata of the 3D dataset resources. It is also used to check if the datas resource exists, or if there is permission to access the datas resource.
Supported output formats: RJSONJSON, JSONP, HTML, XML.
GIS Services Resource Hierarchy
HTTP request methods
Below is an example of performing an HTTP request on a specified URI with rjson as the output format. supermapiserver in the URI is the name of the server.
http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas.rjson
GET Request
Gets a list of all 3D datasets, i.e., the information about the child resources of the datas resource.
Request parameters
| Field | Type | Definition |
| _cache | boolean | [Optional parameters] Whether to use cache, the default is True. False means close all the cache. |
Response structure
Performing a GET request on the datas resource returns a list of 3D datasets. The description of each individual 3D dataset has the following structure:
| Name | Type | Description |
| name | String | The resource name. |
| path | String | The access path of the resource. |
| resourceConfigID | String | ID of the resource configuration. |
| resourceType | String | Resource type. |
| supportedMediaTypes | String[] | Supported media types for descriptions. |
Example usage
Performing a GET request on an example datas resource returns the following representation of the 3D datasets:
[
{
"name": "OlympicGreen",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/OlympicGreen",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "Balloon",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/Balloon",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "Underground",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/Underground",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "ConventionCenter@ConventionCenter",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/ConventionCenter@ConventionCenter",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "dianti",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/dianti",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "flyRoute2",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/flyRoute2",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "flyRoute1",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/flyRoute1",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "BirdNestRoad",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/BirdNestRoad",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "SubwayPoint@RealspaceSample",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/SubwayPoint@RealspaceSample",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "GasPoint@RealspaceSample",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/GasPoint@RealspaceSample",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "BusPoint@RealspaceSample",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/BusPoint@RealspaceSample",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "RoadA@RealspaceSample",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/RoadA@RealspaceSample",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "lawn@RealspaceSample",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/lawn@RealspaceSample",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "buildings@RealspaceSample",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/buildings@RealspaceSample",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "2015beijingsubway",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/2015beijingsubway",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "bridge_beijing",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/bridge_beijing",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "beijing@beijing",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/beijing@beijing",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "WorldMap",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/WorldMap",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "Beijing@RealspaceSample_Terrain",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/Beijing@RealspaceSample_Terrain",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "house@house",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/house@house",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
},
{
"name": "niaochaoyejing",
"path": "http://supermapiserver:8090/iserver/services/3D-sample/rest/realspace/datas/niaochaoyejing",
"resourceConfigID": "map3DData",
"resourceType": "ArithmeticResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"*/*"
],
"visible": true
}
]
HEAD Request
Returns the same HTTP response header as GET does, but no response entity is included. HEAD request can be used to get metadata from the response message header without transporting the entire response content. Metadata includes information about the media type, character encoding, compression encoding, the length of the entity content, etc. The HEAD operation of the image resource can also have request parameters similar to those in the GET operation.
HEAD request can be used to check if the datas resource exists, or if the resource can be accessed by clients. It can also determine if the datas resource supports an output format <format> if performed on a URI with .<format> included.