datas


URI

<3D_uri>/datas[.<format>]

Supported methods

GET, HEAD

Parent resource

3D

Child resources

data

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

Supported output formats: RJSONJSON, JSONP, HTML, XML.

GIS Services Resource Hierarchy

root 3D datas

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.

See