dataset

URI

<sharefile_uri>/{datasetName}[.<format>]

支持的方法

GET、HEAD

父资源

sharefile

子资源

fields

介绍

dataset 资源表示一个数据集，通过对 dataset 资源执行 GET 请求可以获得该数据集的描述信息。

支持的方法：

支持的表述格式：RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/sharefile/d2_World_Capitals.rjson

GET 请求

获取数据集详细信息。

响应结构

对 dataset 资源执行 GET 请求，返回的资源表述的结构如下：

字段 类型 说明
bounds String 数据集范围。当数据文件类型为“UDB” 时返回此参数。
datasetName String 数据集名称。当数据文件类型为“UDB” 时返回此参数。
datasetType DatasetType 数据集类型。当数据文件类型为“UDB” 时返回此参数。
epsgCode int 数据集投影。当数据文件类型为“UDB” 时返回此参数。
name String 数据名称。数据注册到 iServer 时，iServer 将为注册成功的数据集重新命名，名称结构为“存储ID_数据源名_数据集名”。
readOnly boolean 数据集是否为只读。当数据文件类型为“UDB” 时返回此参数。
type BigDataFileShareDatasetInfoType 数据文件的类型。包括 CSV 和 UDB 数据。
url String 数据文件的存放路径。
xIndex int X索引。iServer 将根据索引获取 x 方向上的所有数据。当数据文件类型为“CSV” 时返回此参数。

yIndex

 int Y索引。iServer 将根据索引获取 y 方向上的所有数据。当数据文件类型为“CSV” 时返回此参数。

separator

 String CSV 文件的分隔符。当数据文件类型为“CSV” 时返回此参数。

响应示例

对 dataset 资源：http://supermapiserver:8090/iserver/services/datacatalog/rest/datacatalog/sharefile/d2_World_Capitals.rjson 执行 GET 请求，返回 World_Capitals 数据集的表述如下（World_Capitals 数据集是矢量数据集）：

{

  "bounds": "Left=-175.24565064968198,Bottom=-41.33484005165742,Right=179.22188736363634,Top=64.13499891788544",

  "datasetName": "Capitals",

  "datasetType": "POINT",

  "epsgCode": 4326,

  "name": "d2_World_Capitals",

  "readOnly": false,

  "type": "UDB",

  "url": "E:\\supermap_packages\\data\\World\\World.udb"

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 dataset 资源是否存在，或者客户端是否有权限访问 dataset 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 dataset 资源是否支持<format>格式的表述。

请参见