featureResults

URI

/featureResults[.<format>]

支持的方法

GET、POST、HEAD

父资源

data

子资源

featureResult

介绍

featureResults 资源表示数据查询结果的集合，通过对该资源执行 POST 请求，可以对数据源中的数据进行查询（可跨数据源），获取符合条件的要素集合，对数据进行查询的的步骤如下：

  1. 对 featureResults 执行 POST 请求，在请求体中包含必要的参数，返回一个确定的结果资源（featureResult 资源）的 URI；
  2. 对返回的 URI 进行 GET 操作，得到需要的结果。

进行数据查询，获取要素集合的方式有多种： ID 模式、几何对象的缓冲区模式、缓冲区加属性过滤器模式、空间查询模式、空间查询加属性过滤器的模式、SQL 模式等。若数据来源为ElasticSearch 服务，则获取要素的方式还包括：聚合查询模式。

关于本资源的使用方法，可参考开发指南：数据要素的缓冲区查询。

支持的方法：

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

注：当查询结果要素的类型为点、线、面时，GeoJSON表述可用。

资源层次

根资源 data featureResults.htm

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/data-China400/rest/data/featureResults.rjson

GET 请求

对 featureResults 资源执行 GET 请求，可以获取数据查询结果资源的集合。

请求参数

无。

响应结构

对 featureResults 资源执行 GET 请求，得到的是 featureResult 资源信息的集合，其中单个 featureResult 资源信息的结构如下：

字段 类型 说明
name String featureResult 资源的名称。
path String featureResult 资源的访问路径。
resourceConfigID String 资源配置项 ID。
resourceType String 资源类型。
supportedMediaTypes String[] 数据源资源支持的表述的媒体类型。

示例

在一次成功的数据查询（即对 featureResults 成功执行 POST 请求）后，featureResults 资源里保存了查询结果的信息，对 featureResults 资源执行 GET 请求，返回 rjson 格式的资源描述如下：

[

   {

        "name": "c97763682c0f4eebb392a704ab8273b2_8fe12768e9244972bd4c051fde8b53ee",

        "path": "http://supermapiserver:8090/iserver/services/data-China400/rest/data/featureResults/c97763682c0f4eebb392a704ab8273b2_8fe12768e9244972bd4c051fde8b53ee.rjson",

        "resourceConfigID": null,

        "resourceType": "ArithResultResource",

        "supportedMediaTypes": [

            "application/xml",

            "text/xml",

            "application/json",

            "application/fastjson",

            "application/rjson",

            "text/html",

            "application/jsonp",

            "application/x-java-serialized-object"

        ]

    }

]

POST 请求

根据给定条件，创建一个数据查询结果资源。

请求参数

对 featureResults 资源执行 POST 请求，对数据进行查询（即创建一个 featureResult 资源），需传递参数如下：

URI 中的参数

名称 类型 含义
returnContent boolean true 表示直接返回查询结果，即元素类型为 Feature 的数组;false 表示返回创建的 featureResult 资源的 URI。默认不传时为 false。
fromIndex int 查询结果的最小索引号。
默认值是0，如果该值大于查询结果的最大索引号，则查询结果为空。
toIndex int 查询结果的最大索引号。
如果该值大于查询结果的最大索引号，则以查询结果的最大索引号为终止索引号。
returnDatasetInfoOnly boolean 表示是否仅返回要素的数据集信息，默认为false。
returnFeaturesOnly boolean 表示是否仅返回要素信息，默认为false。
returnCountOnly boolean 表示是否仅返回查询结果的要素数量，默认为false。
withIndex boolean 当使用 FlatGeobuf 表述时该参数可选。表示返回的表述为 FlatGeobuf 的结果是否包含空间索引，默认为true。

 

请求体参数

在请求体中包含查询参数，如下所示。其中，getFeatureMode 标识了数据查询的模式，数据查询模式不同，所需要的参数也不同。

名称 类型 含义
getFeatureMode GetFeatureMode 【必选参数】
数据查询的模式。有 ID、SQL、BOUNDS、BOUNDS_ATTRIBUTEFILTER、BUFFER、BUFFER_ATTRIBUTEFILTER、SPATIAL、SPATIAL_ATTRIBUTEFILTER 等。
如果对三维点、线、面、模型数据集进行查询，则目前支持的查询模式有 ID、SQL、BOUNDS、BOUNDS_ATTRIBUTEFILTER。
datasetNames String[] 【必选参数】
数据集名称数组(datasourceName:datasetName)。
数据集名称由数据源名和数据集名构成，例如 World 数据源下的 Ocean 数据集，这里的数据集名称就是“World:Ocean”。
ids int[] 要获取的资源的 ID 数组。
当 getFeatureMode（查询模式）为ID时，此参数必选。
Elasticsearch数据查询支持的数据类型：Geo_Point、Geo_Shape。
对于Elasticsearch数据，当数据为字符串类型，需加引号。
bounds Rectangle2D 进行范围查询时，需要设置的矩形坐标范围。
当 getFeatureMode（查询模式）为BOUNDS、BOUNDS_ATTRIBUTEFILTER时，此参数必选。  
Elasticsearch数据查询支持的数据类型：Geo_Point、Geo_Shape。
geometry Geometry 几何对象。
当 getFeatureMode（查询模式）为BUFFER、BUFFER_ATTRIBUTEFILTER、SPATIAL、SPATIAL_ATTRIBUTEFILTER时，此参数必选。
bufferDistance double 缓冲区半径，单位和数据集坐标单位一致。
当 getFeatureMode（查询模式）为BUFFER、BUFFER_ATTRIBUTEFILTER时，此参数必选。  
不支持Elasticsearch数据来源。
attributeFilter String 属性查询过滤器。
当 getFeatureMode（查询模式）为BUFFER_ATTRIBUTEFILTER、SPATIAL_ATTRIBUTEFILTER、BOUNDS_ATTRIBUTEFILTER时，此参数必选。
当 getFeatureMode（查询模式）为 SQL 时，如果在系统配置文件（参见：iServer 配置文件说明）中设置了 SQL 查询表达式中需要屏蔽掉的字符串，那么在属性查询过滤器中一旦发现输入了已经设置的字符串，系统会认为该条查询表达式非法并返回400参数异常，防止 SQL 注入。如果在系统配置文件中没有设置 SQL 查询表达式中需要屏蔽掉的字符串，那么在属性查询过滤器中会默认屏蔽掉分号。
此外，若您查询的数据量较大，且存储在 PostGIS、PostgreSQL、MySQL 等空间数据库中时，如果该数据库支持空间几何函数查询，您还可以将数据库几何函数作为查询条件，利用空间数据库进行计算，从而缓解 iServer 计算压力，提高返回结果的速度。请求体示例参见 示例8：SQL查询-以空间几何函数为查询条件
spatialQueryMode SpatialQueryMode 空间查询模式。
当 getFeatureMode（查询模式）为SPATIAL、SPATIAL_ATTRIBUTEFILTER时，此参数必选。
Elasticsearch数据查询支持的数据类型：Geo_Point、Geo_Shape。
当数据类型为Geo_Point时，支持的空间查询模式仅为CONTAIN。
当数据类型为Geo_Shape时，支持的空间查询模式CONTAIN、WITHIN、INTERSECT、DISJOINT。
maxFeatures int 进行 SQL 查询时，用于设置服务端返回查询结果条目的数量，默认为1000。
当该值大于fromIndex与toIndex区间内查询结果的个数，则返回索引区间内所有结果
当该值小于等于fromIndex与toIndex区间内查询结果的个数，则返回索引区间内从fromIndex起，指定数量的结果
queryParameter QueryParameter 查询参数。
这里已包含设置获取的结果字段名。
当 getFeatureMode（查询模式）为SQL时，此参数必选。
Elasticsearch数据查询支持的数据类型：Geo_Point、Geo_Shape。
对于Elasticsearch数据，当字段值包含大写时，查询条件不加引号。
对于Elasticsearch数据，查询条件暂不支持区分大小写。例如：当查询条件为 NAME=G12时 ，NAME=G12或NAME=g12符合条件的结果均会查询。
对于Elasticsearch数据，SQL查询仅支持常见操作符，如“>” 、“< ”、“=” 等，其中“=”匹配内容仅支持数字；一些函数运算如：max()，min()，以及like操作符等尚不支持。
targetPrj PrjCoordSys 动态投影的目标坐标系。
当此参数设置的坐标系统不同于数据的原有坐标系统时， 系统会进行动态投影，并返回动态投影后的查询结果。 参数使用时，需按照PrjCoordSys中的字段结构来构建，同时也支持通过只传递 epsgCode 的方式传入坐标参考系。
建议当目标投坐标系无对应的EpsgCode时，使用此参数。
使用时，需在请求url中添加returnContent参数，并设值为true
targetEpsgCode int 动态投影的目标坐标系对应的EPSG Code。 使用时，需在请求url中添加returnContent参数，并设值为true
targetEpsgCode和targetPrj均可设置动态投影的目标坐标系，当两者都设置时，以targetEpsgCode为准。

aggregations

 AggregationParameter 聚合查询参数（仅支持Elasticsearch数据源）。
使用聚合查询时，首先需要通过数据查询获得需要进行聚合查询的点数据集。目前支持的数据查询模式有BOUNDS、BOUNDS_ATTRIBUTEFILTER、SPATIAL、SPATIAL_ATTRIBUTEFILTER、ID、SQL等六种，您可根据需求进行选择。 请注意，在聚合查询中使用BOUNDS查询时，需将bounds参数中的坐标设置在x=[-180,180]，y=[-90,90]的范围内。
目前聚合查询支持以下两种聚合模式：
  • 格网聚合查询（GeoHashGridAggParameter），是实现基于格网划分对点要素数量count进行统计的聚合查询模式。具体指通过格网对地图要素进行划分，然后计算每个网格内点要素的数量count，最后返回包含count字段的点集合。格网聚合查询字段结构中包含精度precision，参数范围为1-12，默认为5。其中12代表最高精度，此时一个网格仅可覆盖小于1平方米的面积。
  • 指标聚合查询（MetricsAggParameter），是实现对点要素的指定字段进行最大、最小、平均或求和统计的聚合查询模式。具体指根据最大（max）、最小（min）、平均（avg）、求和（sum）几种统计类型，对点要素的指定属性字段进行统计，最后返回包括统计值字段的点。通常情况下使用指标聚合查询时，建议您与网格聚合查询结合，从而实现返回包括 统计值字段的聚合结果点数据集。如果您仅使用使用指标聚合查询，则将返回包含统计值的单个点。
请注意，在使用聚合查询参数时，需在请求url中添加returnContent参数，并设值为true。例如：http://supermapiserver:8090/iserver/services/data-es/rest/data/featureResults.rjson?returnContent=true

hasGeometry

 boolean 是否返回空间几何对象信息。默认为true。当 getFeatureMode 不为 ID 时，且 URL 参数 returnContent=true 时，hasGeometry 有效。

响应结构

对 featureResults 资源执行 POST 请求，返回的创建结果的结构如下：

字段 类型 含义
succeed boolean 数据查询是否成功。
newResourceID String 创建的 featureResult 资源的 ID。
newResourceLocation String 创建的 featureResult 资源的 URI。

如果 URI 参数 returnContent 为 true，则返回查询结果，其结构如下：

字段 类型 含义
featureCount int 返回的要素个数。
features String[] 返回的要素列表。
totalCount int 要素总个数。
featureUriList String[] 返回的要素子资源地址。

datasetInfos

 String[] 返回的数据集信息

其中要素集合，即 features 字段中单个元素的描述结构如下：

名称 类型 含义
ID int 要素的 ID。
fieldNames String[] 要素的属性字段名集合。
fieldValues String[] 要素的属性字段值集合。
geometry Geometry 要素对应的几何对象。当hasGeometry为false时，返回的geometry的值为null。

示例1

对示例 featureResults 资源：http://supermapiserver:8090/iserver/services/data-world/rest/data/featureResults.rjson 执行 POST 请求（returnContent 默认不传，则为 false），对 supermapiserver 服务器上的数据进行查询，根据 ID 来获取要素，请求体中的参数如下：

{

"getFeatureMode":"ID",

"datasetNames":["World:Capitals"],

"ids":[1, 2, 3]

}

返回 rjson 格式的操作结果表述如下：

{

    "newResourceID": "48ba8fa1144640939a944f75e1682265_99dabf94794248c38776711d859164af",

    "newResourceLocation": "http://localhost:8080/iserver/services/data-world/rest/data/featureResults/48ba8fa1144640939a944f75e1682265_99dabf94794248c38776711d859164af.rjson",

    "postResultType": "CreateChild",

    "succeed": true

}

示例2

对示例 featureResults 资源：http://supermapiserver:8090/iserver/services/data-World/rest/data/featureResults.geojson?returnContent=true 执行 POST 请求，对 supermapiserver 服务器上的数据进行查询，根据 ID 来获取要素，请求体中的参数如下：

{

"getFeatureMode":"ID",

"datasetNames":["World:capital"],

"ids":[1]

}

返回 geojson 格式的操作结果表述如下：

{

    "features":[

    {

        "geometry":{

            "coordinates":[-47.8977476573595,-15.792110943058866],

            "type":"Point"

        },

        "id":"1",

        "type":"Feature",

        "properties":{

            "SMLIBTILEID":"1",

            "COUNTRY_CH":"巴西",

            "CAPITAL_EN":"Brasilia",

            "POP":"2207718.0",

            "CAPITAL_CH":"巴西利亚",

            "SMID":"1",

            "CAPITAL_LO":"Brasília",

            "COUNTRY_EN":"Brazil",

            "USERID":"0",

            "SMGEOPOSITION":"266502144",

            "SMGEOMETRYSIZE":"20",

            "SMY":"-15.792110943058866",

            "SMX":"-47.8977476573595",

            "SMUSERID":"0"

        }

    }],

    "type":"FeatureCollection"

}

示例3：查询并返回动态投影后的要素（设置 targetEpsgCode 参数）

对示例 featureResults 资源：http://supermapiservert:8090/iserver/services/data-China400/rest/data/featureResults.rjson?returnContent=true 执行 POST 请求，对 supermapiserver 服务器上的数据进行查询，根据 SQL来获取要素，并转换投影坐标系。请求体中的参数如下：

{

"getFeatureMode":"SQL",

"datasetNames":["World:Capitals"],

"targetEpsgCode":3857,

"maxFeatures":1000,

"queryParameter":{

     "sortClause":null,

     "ids":null, "name":"Capital",

     "attributeFilter":"SMID%26lt;5",

     "groupClause":null,

     "linkItems":null,

     "joinItems":null,

     "fields":null

  },

hasGeometry:true

 }

返回 rjson 格式的操作结果表述如下：

{

    "featureCount": 1,

    "featureUriList": [],

    "features": [{

        "ID": 1,

        "fieldNames": [

            "SMID",

            "SMX",

            "SMY",

            "SMLIBTILEID",

            "SMUSERID",

            "SMGEOMETRYSIZE",

            "USERID",

            "POP",

            "CAPITAL_LO",

            "CAPITAL_CH",

            "COUNTRY_CH",

            "CAPITAL_EN",

            "COUNTRY_EN",

            "COUNTRY",

            "CAP_POP",

            "CAPITAL"

        ],

        "fieldValues": [

            "1",

            "-47.8977476573595",

            "-15.792110943058866",

            "1",

            "0",

            "16",

            "0",

            "2207718.0",

            "Brasília",

            "巴西利亚",

            "巴西",

            "Brasilia",

            "Brazil",

            "巴西",

            "2207718.0",

            "巴西利亚"

        ],

        "geometry": {

            "center": {

                "x": -5331952.879361972,

                "y": -1780660.5109428319

            },

            "id": 1,

            "parts": [1],

            "points": [{

                "x": -5331952.879361972,

                "y": -1780660.5109428319

            }],

            "prjCoordSys": null,

            "style": null,

            "type": "POINT"

        }

    }],

    "totalCount": 1

}

示例4：通过 SQL 查询条件删除Elasticsearch数据要素

对示例 featureResults 资源：http://supermapiservert:8090/iserver/services/data-es/rest/data/featureResults.json?returnContent=true 执行 POST 请求，对 supermapiserver 服务器上的数据进行查询，根据 SQL来获取要素。请求体中的参数如下：

{

    "getFeatureMode": "SQL",

    "datasetNames": [

        "居民点:supermap"

    ],

    "maxFeatures": 1000,

    "queryParameter": {

        "sortClause": null,

        "ids": null,

        "name": null,

        "attributeFilter": "MAPTN = G4805200250",

        "groupClause": null,

        "linkItems": null,

        "joinItems": null,

        "fields": null

    }

}

返回 rjson 格式的操作结果表述如下：

{

    "features": [],

    "featureUriList": [

        {

            "stringID": "AWTJ_JNbQGqPLMwBycPm",

            "fieldNames": [

                "AREA",

                "CODE",

                "COVERAGE",

                "COVERAGE_ID",

                "GB",

                "MAPTN",

                "PERIMETER",

                "RNAME",

                "SmID",

                "TN",

                "ZValue"

            ],

            "geometry": {

                "center": {

                    "x": 102.09679,

                    "y": 26.921792

                },

                "parts": [

                    1

                ],

                "style": null,

                "prjCoordSys": null,

                "id": 0,

                "type": "POINT",

                "partTopo": null,

                "points": [

                    {

                        "x": 102.09679,

                        "y": 26.921792

                    }

                ]

            },

            "fieldValues": [

                "0.0",

                "211",

                "25",

                "25",

                "31091",

                "G4805200250",

                "0.0",

                "新林村",

                "4139",

                "200250",

                "1200.0"

            ],

            "ID": 0

        },

        {

            "stringID": "AWXNF_e10qCuSb4ZYqo-",

            "fieldNames": [

                "AREA",

                "CODE",

                "COVERAGE",

                "COVERAGE_ID",

                "GB",

                "MAPTN",

                "PERIMETER",

                "RNAME",

                "SmID",

                "TN",

                "ZValue"

            ],

            "geometry": {

                "center": {

                    "x": 102.09679,

                    "y": 26.921792

                },

                "parts": [

                    1

                ],

                "style": null,

                "prjCoordSys": null,

                "id": 0,

                "type": "POINT",

                "partTopo": null,

                "points": [

                    {

                        "x": 102.09679,

                        "y": 26.921792

                    }

                ]

            },

            "fieldValues": [

                "0.0",

                "211",

                "25",

                "25",

                "31091",

                "g4805200250",

                "0.0",

                "新林村",

                "4139",

                "200250",

                "1200.0"

            ],

            "ID": 0

        }

    ],

    "totalCount": 2,

    "featureCount": 2

}

示例5：查询并返回动态投影后的要素（设置 targetPrj 参数）

对示例 featureResults 资源：http://supermapiservert:8090/iserver/services/data-world/rest/data/featureResults.rjson?returnContent=true 执行 POST 请求，对 supermapiserver 服务器上的数据进行查询，根据 SQL来获取要素，通过设置 targetPrj 参数转换投影坐标系，targetPrj 参数的构造参考PrjCoordSys。请求体中的参数示例如下：

{

"getFeatureMode":"SQL",

"targetPrj": {

            "coordSystem": {

                "datum": {

                    "name": "D_Timbalai_1948",

                    "spheroid": {

                        "axis": 6377298.556,

                        "flatten": 0.003324448999999486,

                        "name": "Everest_Definition_1967",

                        "type": "SPHEROID_EVEREST_DEF_1967"

                    },

                    "type": "DATUM_TIMBALAI_1948"

                },

                "name": "GCS_Timbalai_1948",

                "primeMeridian": {

                    "longitudeValue": 0,

                    "name": "Greenwich",

                    "type": "PRIMEMERIDIAN_GREENWICH"

                },

                "spatialRefType": "SPATIALREF_EARTH_LONGITUDE_LATITUDE",

                "type": "GCS_TIMBALAI_1948",

                "unit": "DEGREE"

            },

            "coordUnit": "METER",

            "distanceUnit": "METER",

            "epsgCode": 29873,

            "name": "Timbalai_1948_RSO_Borneo_Meters",

            "projection": {

                "name": "",

                "type": "PRJ_RECTIFIED_SKEWED_ORTHOMORPHIC"

            },

            "projectionParam": {

                "azimuth": 53.31582047908623,

                "centralMeridian": 115,

                "centralParallel": 4,

                "falseEasting": 2000000,

                "falseNorthing": 5000000,

                "firstPointLongitude": 0,

                "firstStandardParallel": 0,

                "scaleFactor": 0.99984,

                "secondPointLongitude": 0,

                "secondStandardParallel": 0,

                "rectifiedAngle":53.13010235415598

            }},

"datasetNames":["World:Capitals"],

"maxFeatures":1000,

"queryParameter":{"sortClause":null, "ids":null, "name":"Capital", "attributeFilter":"SMID%26lt;2", "groupClause":null, "linkItems":null, "joinItems":null, "fields":null}

}

返回 rjson 格式的操作结果表述如下：

{

    "featureCount": 1,

    "featureUriList": [],

    "features": [{

        "ID": 1,

        "fieldNames": [

            "SMID",

            "SMX",

            "SMY",

            "SMLIBTILEID",

            "SMUSERID",

            "SMGEOMETRYSIZE",

            "USERID",

            "POP",

            "CAPITAL_LO",

            "CAPITAL_CH",

            "COUNTRY_CH",

            "CAPITAL_EN",

            "COUNTRY_EN",

            "COUNTRY",

            "CAP_POP",

            "CAPITAL"

        ],

        "fieldValues": [

            "1",

            "-47.8977476573595",

            "-15.792110943058866",

            "1",

            "0",

            "16",

            "0",

            "2207718.0",

            "Brasília",

            "巴西利亚",

            "巴西",

            "Brasilia",

            "Brazil",

            "巴西",

            "2207718.0",

            "巴西利亚"

        ],

        "geometry": {

            "center": {

                "x": 4379183.5624869745,

                "y": 6771032.568773773

            },

            "id": 1,

            "parts": [1],

            "points": [{

                "x": 4379183.5624869745,

                "y": 6771032.568773773

            }],

            "prjCoordSys": null,

            "style": null,

            "type": "POINT"

        }

    }],

    "totalCount": 1

}

示例6：基于格网的最大值聚合查询（设置 aggregations 参数）

对示例 featureResults 资源：http://supermapiserver:8090/iserver/services/data-es/rest/data/featureResults.rjson?returnContent=true 执行 POST 请求，对 ES 数据进行基于 BOUNDS 查询的格网-最大值聚合查询，首先通过设置 bounds 参数对 ES 数据进行 BOUNDS 查询获取数据集，然后设置 aggregations 参数实现对获取到的数据集进行格网划分并对 fee 字段进行最大值指标聚合查询，请求体中的参数如下：

{

    "getFeatureMode": "BOUNDS",

    "datasetNames": [

        "test1100:_doc"

    ],

    "bounds": {

        "leftBottom":   {

                "x":-136.38671875,

                "y":-54.345703125

            },

        "rightTop":   {

                "x":116.38671875,

                "y":84.345703125

            }

    },

    "spatialQueryMode": "CONTAIN",

    "maxFeatures":10000,

    "aggregations": {

        "aggName": "test",

        "aggType": "geohash_grid",

        "aggFieldName": "location",

        "precision": 3,

        "subAggs": [{

             "aggName":"test2",

             "aggType":"max",

             "aggFieldName":"fee",

             "subAgg":null

          }]

    }

}

返回 rjson 格式的操作结果表述如下：

{

    "featureCount": 215,

    "featureUriList": [],

    "features": [{

        "ID": 0,

        "fieldNames":[

           "test",

           "test2"

        ],

        "fieldValues":[

           "1996.52",

           "1408"

        ],

        "geometry": {

            "center": {

                "x": 115.3125,

                "y": 39.375

            },

            "id": 0,

            "parts": [1],

            "partTopo": null,

            "points": [{

                "x": 115.3125,

                "y": 39.375

            }],

            "prjCoordSys": null,

            "style": null,

            "type": "POINT"

          }

      }

      ......

    ],

    "totalCount": 215

}

示例7

对示例 featureResults 资源：http://supermapiserver:8090/iserver/services/data- testdatahbase /rest/data/featureResults.rjson?returnContent=true 执行 POST 请求，对分布式数据使用 ECQL 语言进行查询，获取要素，请求体中的参数示例如下：

{

"getFeatureMode": "SQL",

"datasetNames": ["testdatahbase:Muifa_4326"],

"maxFeatures": 1000,

"queryParameter": {

"sortClause": null,

"ids": null,

"name": null,

"attributeFilter": "BBOX(the_geom,131.03,23.35,132.87,24.97)",

"groupClause": null,

"linkItems": null,

"joinItems": null,

"fields": null

}

}

返回 rjson 格式的操作结果表述如下：

{

    "features": [],

" featureUriList ": [

{

"stringID": "00a3e328-9ac0-4765-9ad7-d3b19f00fcda",

"fieldNames": [

"SmID",

"TIME",

"STRENGTH",

"LAT",

"LON",

"PRES",

"WND",

"NAME",

"RTime"

],

"geometry": {

"center": {

"x": 132.8,

"y": 24.1

},

"parts": [1],

"style": null,

"prjCoordSys": null,

"id": 0,

"type": "POINT",

"partTopo": null,

"points": [{

"x": 132.8,

"y": 24.1

}]

},

"fieldValues": [

"29",

"2011080300",

"5.0",

"24.1",

"132.8",

"940.0",

"50.0",

"梅花",

"2011-08-02T16:00:00.000Z"

],

"ID": 0

}

{

"stringID": "70a3e328-9a8a-43fc-85b8-9301195874d0",

……

}

{

"stringID": "30a3e328-9a8b-436e-bda5-9142b3826a6a",

……

}

],

"totalCount": 3

"featureCount": 3

}

示例8：SQL查询—以空间几何函数为查询条件

对示例 featureResults 资源：http://supermapiserver:8090/iserver/services/data-postgisMap/rest/data/featureResults.rjson?returnContent=true 执行 POST 请求，对 supermapiserver 服务器上的数据进行查询，根据以空间几何函数为条件的 SQL 查询来获取要素。请求体中的参数如下：

{

"getFeatureMode":"SQL",

"datasetNames":["postgisMap:basemap_p"],

"maxFeatures":2,

"queryParameter":{

     "sortClause":null,

     "ids":null,

     "name":null,

     "attributeFilter":"ST_Intersects(basemap_p.smgeometry,st_geomfromgeojson('{\"type\":\"Line\",\"coordinates\":[[[117.39993002089760,40.0590434404580],[117.39993002089765,40.0590434404588]]]}'))",

     "groupClause":null,

     "linkItems":null,

     "joinItems":null,

     "fields":null

  },

hasGeometry:false

 }

返回 rjson 格式的操作结果表述如下：

{

    "featureCount": 1,

    "featureUriList": [],

    "features": [{

        "ID": 1,

        "fieldNames": [

            "smuserid",

            "userid",

            "name",

            "code",

            "adclass",

            "adclass_1"  

        ],

        "fieldValues": [

            "0",

            "21",

            "蓟县",

            "120225",

            "4",

            "0.0"

        ],

    }],

    "totalCount": 1

}

示例9：仅返回数据集信息（设置 returnDatasetInfoOnly 参数）

对示例 featureResults 资源： http://supermapiserver:8090/iserver/services/data-World/rest/data/featureResults.rjson?returnDatasetInfoOnly=true&returnContent=true  执行 POST 请求，对 supermapiserver 服务器上的数据集进行查询，请求体中的参数如下：

{

"getFeatureMode":"ID",

"datasetNames":["World:capital"],

"ids":[1,2,3]

}

返回 rjson 格式的操作结果表述如下：

[{

    "fieldInfos": [

        {

            "name": null,

            "caption": null,

            "type": null

        },

        {

            "name": null,

            "caption": null,

            "type": null

        },

        {

            "name": null,

            "caption": null,

            "type": null

        },

        {

            "name": "USERID",

            "caption": "USERID",

            "type": "INT32"

        },

        {

            "name": "POP",

            "caption": "POP",

            "type": "DOUBLE"

        },

        {

            "name": "CAPITAL_LO",

            "caption": "CAPITAL_LO",

            "type": "WTEXT"

        },

        {

            "name": "CAPITAL_CH",

            "caption": "CAPITAL_CH",

            "type": "WTEXT"

        },

        {

            "name": "COUNTRY_CH",

            "caption": "COUNTRY_CH",

            "type": "WTEXT"

        },

        {

            "name": "CAPITAL_EN",

            "caption": "CAPITAL_EN",

            "type": "WTEXT"

        },

        {

            "name": "COUNTRY_EN",

            "caption": "COUNTRY_EN",

            "type": "WTEXT"

        }

    ],

    "featureRange": {

        "start": 0,

        "end": 2

    },

    "datasetName": "World:capital"

}]

HEAD 请求

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

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

 

请参见