dataset


URI

  1. <datasets_uri>/{datasetName}[.<format>]

  2. <datasets_uri>/{datasetIndex}[.<format>]

Supported methods

GET, HEAD

Parent resource

datasets

Child resource

datasetBufferResults, datasetOverlayResults, datasetIsolineResults, datasetIsoregionResults, datasetInterpolation, datasetGeorelationResults, datasetLinearReferencing, datasetThiessenPolygonResults, RelativePosition3D, SpatialQuery3D, gridMathAnalyst, terraincaCalulation, Density, datasetMinDistanceResults

Introduction

The data resource provides detailed information about a certain dataset.

Supported methods:

Supported output formats: rjson, json, jsop, html, xml.

GIS Services Resource Hierarchy

HTTP request methods

Below is an example of performing an HTTP request on a URI with rjson as the output format. supermapiserver in the URI is the name of the server.

http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation.rjson

GET request

Gets information about a dataset as well as its child resources, i.e., the supported spatial analysis functions (different spatial analysis functions are supported depending on the type of the dataset).

Response structure

The representation of the DatasetInfo class is returned.

Filed Type Description
datasetInfo DatasetInfo Information about the dataset.
childResourceInfos List<ChildResourceInfo> Information about the child resources, i.e., a list of spatial analysis operations that can be performed on this dataset.

Example usage

Below is the returned representation in RJSON format after a GET request is performed on the dataset resource: http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation.rjson:

{

    "childResourceInfos": [{

        "name": "datasetBufferResults",

        "path": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/buffer",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null,

        "visible": true

    },

    {

        "name": "datasetGeorelationResults",

        "path": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/georelation",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null,

        "visible": true

    },

    {

        "name": "datasetInterpolation",

        "path": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/interpolation",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null,

        "visible": true

    },

    {

        "name": "datasetIsolineResults",

        "path": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/isoline",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null,

        "visible": true

    },

    {

        "name": "datasetIsoregionResults",

        "path": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/isoregion",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null,

        "visible": true

    },

    {

        "name": "datasetOverlayResults",

        "path": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/overlay",

        "resourceConfigID": null,

        "resourceType": null,

        "supportedMediaTypes": null,

        "visible": true

    }],

    "datasetInfo": {

        "bounds": {

            "bottom": 1884474.0662141703,

            "left": -2419318.165185321,

            "leftBottom": {

                "x": -2419318.165185321,

                "y": 1884474.0662141703

            },

            "right": 2137211.956299985,

            "rightTop": {

                "x": 2137211.956299985,

                "y": 5846399.0117541645

            },

            "top": 5846399.0117541645

        },

        "charset": "GB18030",

        "dataSourceName": "Interpolation",

        "description": "",

        "encodeType": "NONE",

        "isFileCache": false,

        "isReadOnly": false,

        "name": "SamplesP",

        "prjCoordSys": {

            "coordSystem": {

                "datum": {

                    "name": "D_China_2000",

                    "spheroid": {

                        "axis": 6378137,

                        "flatten": 0.003352810681182319,

                        "name": "China_2000",

                        "type": "SPHEROID_CHINA_2000"

                    },

                    "type": "DATUM_CHINA_2000"

                },

                "name": "GCS_China_2000",

                "primeMeridian": {

                    "longitudeValue": 0,

                    "name": "Greenwich",

                    "type": "PRIMEMERIDIAN_GREENWICH"

                },

                "spatialRefType": "SPATIALREF_EARTH_LONGITUDE_LATITUDE",

                "type": "GCS_CHINA_2000",

                "unit": "DEGREE"

            },

            "coordUnit": "METER",

            "distanceUnit": "METER",

            "epsgCode": -1000,

            "name": "User Define",

            "projection": {

                "name": "Albers",

                "type": "PRJ_ALBERS"

            },

            "projectionParam": {

                "azimuth": 0,

                "centralMeridian": 105,

                "centralParallel": 0,

                "falseEasting": 0,

                "falseNorthing": 0,

                "firstPointLongitude": 0,

                "firstStandardParallel": 25,

                "scaleFactor": 1,

                "secondPointLongitude": 0,

                "secondStandardParallel": 47

            },

            "type": "PCS_USER_DEFINED"

        },

        "recordCount": 400,

        "tableName": "SamplesP",

        "type": "POINT"

    },

    "name": null,

    "path": null

}

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.

HEAD request can be used to check if the dataset resource exists, or if the resource can be accessed by clients. It can also determine if the dataset resource supports an output format <format> if performed on a URI with .<format> included.

See