datasets

URI

<spatiotemporal_uri>/datasets[.<format>]

Supported methods

GET, HEAD

Parent resource

spatiotemporal

Child resources

dataset

Introduction

The datasets resource represents a collection of all the datasets in a datasource.

Supported Methods:

GET: Get the information of all the datasets in a datasource.
HEAD: Checks whether the datasets resource exists or whether there is a permission to access the resource.

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

Resource hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.

http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/spatiotemporal/datasets.rjson

GET request

Get the information of all the datasets in a datasource.

Response structure

The structure of the response resource representation after implementing the GET request on the datasets resource will be as follows:

Field	Type	Description
datasetNames	List<String>	Name list of imported data.
datasetCount	int	Dataset count of imported data package.
childUriList	List<String>	URI list to visit data package.

Response example

The returned rjson format representation after implementing the GET request on the datas resource http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/realtime/datasets.rjson is as follows:

{

"childUriList": ["http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/realtime/datasets/tuit"],

"datasetCount": 1,

"datasetNames": ["tuit"]

}

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check whether the datasets resource exists, or whether the the client has the permission to access it. It can also determine if the datasets resource supports an output format <format> if performed on a URI with .<format> included.