dataset


URI

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

支持的方法

GETHEAD

父资源

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>格式的表述。

请参见