/featureResults[.<format>]
featureResults 资源表示数据查询结果的集合，通过对该资源执行 POST 请求，可以对数据源中的数据进行查询（可跨数据源），获取符合条件的要素集合，对数据进行查询的的步骤如下：
进行数据查询，获取要素集合的方式有多种： ID 模式、几何对象的缓冲区模式、缓冲区加属性过滤器模式、空间查询模式、空间查询加属性过滤器的模式、SQL 模式等。若数据来源为ElasticSearch 服务，则获取要素的方式还包括：聚合查询模式。
关于本资源的使用方法，可参考开发指南：数据要素的缓冲区查询。
支持的方法：
支持的表述格式：RJSON、JSON、HTML、XML、GeoJSON、FlatGeobuf。
注：当查询结果要素的类型为点、线、面时，GeoJSON表述可用。
对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/data-China400/rest/data/featureResults.rjson
对 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"
]
}
]
根据给定条件，创建一个数据查询结果资源。
若查询性能较低，建议：1） 给数据集创建空间索引或字段索引；2）查询时设置参数 returnFeaturesOnly=true。
对 featureResults 资源执行 POST 请求，对数据进行查询（即创建一个 featureResult 资源），需传递参数如下：
URI 中的参数
| 名称 | 类型 | 含义 |
| returnContent | boolean | true 表示直接返回查询结果，即元素类型为 Feature 的数组;false 表示返回创建的 featureResult 资源的 URI。默认不传时为 false。 |
| fromIndex | int | 查询结果的最小索引号。
默认值是0，如果该值大于查询结果的最大索引号，则查询结果为空。 |
| toIndex | int | 查询结果的最大索引号。
如果该值大于查询结果的最大索引号，则以查询结果的最大索引号为终止索引号。 |
| returnDatasetInfoOnly | boolean | 表示是否仅返回要素的数据集信息，默认为false。 |
| returnFeaturesOnly | boolean | 表示是否仅返回要素信息，默认为false。当 returnContent 为 true 时生效。 |
| returnCountOnly | boolean | 表示是否仅返回查询结果的要素数量，默认为false。 |
| withIndex | boolean | 当使用 FlatGeobuf 表述时该参数可选。表示返回的表述为 FlatGeobuf 的结果是否包含空间索引，默认为true。 |
注：其中参数优先级：returnCountOnly > returnFeaturesOnly > returnDatasetInfoOnly。
在请求体中包含查询参数，如下所示。其中，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起，指定数量的结果 当该值等于-1， 将返回全部结果（不受默认1000的限制），但优先级低于fromIndex和toIndex |
| queryParameter | QueryParameter | 查询参数。
这里已包含设置获取的结果字段名。 当 getFeatureMode（查询模式）为SQL时，此参数必选。 注意，当使用分组条件（groupBy）查询参数时，只支持属性查询，针对非 udb 或 udbx 的数据库型数据源需设置查询字段为分组字段或其他统计字段，并且不支持在 iServer 前端 REST API 界面进行分组条件（groupBy）查询，可以通过调用 REST API 接口方式（例如：Fiddler、Postman）进行分组条件（groupBy）查询。 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为准。 |
| AggregationParameter | 聚合查询参数（仅支持Elasticsearch数据源）。
使用聚合查询时，首先需要通过数据查询获得需要进行聚合查询的点数据集。目前支持的数据查询模式有BOUNDS、BOUNDS_ATTRIBUTEFILTER、SPATIAL、SPATIAL_ATTRIBUTEFILTER、ID、SQL等六种，您可根据需求进行选择。 请注意，在聚合查询中使用BOUNDS查询时，需将bounds参数中的坐标设置在x=[-180,180]，y=[-90,90]的范围内。 目前聚合查询支持以下两种聚合模式：
|
|
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 |
返回的数据集信息，包括数据集名称、数据集字段信息（字段名、字段别名和字段类型）以及数据集查询出的要素在 features 字段中的索引范围 |
其中要素集合，即 features 字段中单个元素的描述结构如下：
| 名称 | 类型 | 含义 |
| ID | int | 要素的 ID。 |
| fieldNames | String[] | 要素的属性字段名集合。 |
| fieldValues | String[] | 要素的属性字段值集合。 |
| geometry | Geometry | 要素对应的几何对象。当hasGeometry为false时，返回的geometry的值为null。 |
对示例 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
}
对示例 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"
}
对示例 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
}
对示例 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
}
对示例 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
}
对示例 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
}
对示例 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
}
对示例 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
}
对示例 featureResults 资源： http://supermapiserver:8090/iserver/services/data-China100/rest/data/featureResults.json?returnDatasetInfoOnly=true 执行 POST 请求，对 supermapiserver 服务器上的数据集进行查询，请求体中的参数如下：
{
"getFeatureMode":"ID",
"datasetNames":["China:Airport_pt", "China:China_Island"],
"ids":[1,2,3]
}
返回 rjson 格式的操作结果表述如下：
[{
"fieldInfos": [
{
"name":"SmID",
"caption":"SmID",
"type":"INT32"
},
{
"name":"SmUserID",
"caption":"SmUserID",
"type":"INT32"
},
{
"name":"GB",
"caption":"GB",
"type":"DOUBLE"
},
{
"name":"RN",
"caption":"RN",
"type":"WTEXT"
},
{
"name":"NAME",
"caption":"NAME",
"type":"WTEXT"
},
{
"name":"PERIOD",
"caption":"PERIOD",
"type": "WTEXT"
},
{
"name":"BRGLEV",
"caption":"BRGLEV",
"type":"DOUBLE"
},
{
"name":"ANGLE",
"caption":"ANGLE",
"type":"DOUBLE"
}
],
"featureRange": {
"start": 0,
"end": 2
},
"datasetName":"China:Airport_pt"
},
{
"fieldInfos": [
{
"name":"SmID",
"caption":"SmID",
"type":"INT32"
},
{
"name":"SmUserID",
"caption":"SmUserID",
"type":"INT32"
},
{
"name":"SmArea",
"caption":"SmArea",
"type":"DOUBLE"
},
{
"name":"SmPerimeter",
"caption":"SmPerimeter",
"type":"DOUBLE"
},
{
"name":"GB",
"caption":"GB",
"type":"DOUBLE"
},
{
"name":"NAME",
"caption":"NAME",
"type":"WTEXT"
},
{
"name":"SHAPE_Leng",
"caption":"SHAPE_Leng",
"type": "DOUBLE"
},
{
"name":"SHAPE_Area",
"caption":"SHAPE_Area",
"type":"DOUBLE"
},
{
"name":"PAC",
"caption":"PAC",
"type":"DOUBLE"
},
{
"name":"CODE",
"caption":"CODE",
"type":"WTEXT"
},
{
"name":"PINYIN",
"caption":"PINYIN",
"type":"WTEXT"
},
],
"featureRange": {
"start": 3,
"end": 5
},
"datasetName":"China:China_Island"
}]
对示例 featureResults 资源：http://supermapiserver:8090/iserver/services/data-test0104/rest/data/featureResults.rjson?returnContent=true 执行 POST请求，根据地理范围获取视频要素，请求体中的参数如下：
{
"getFeatureMode":"BOUNDS",
"datasetNames":["NewDatasource:ptz旋转画面_2"],
"bounds":{
"leftBottom":{
"x":12929007,
"y":3279156
},
"rightTop":{
"x":12929466,
"y":3279656
}
}
}
返回的 rjsonn 格式的操作结果表述如下：
{
"features": [{
"stringID": null,
"address": "http://192.168.113.1:8090/iserver/services/video-test0104/restjsr/hls/stream/NewDatasource-ptz旋转画面_2/1/index.m3u8",
"videoParameters": {
"auxiliaryCalibrationParameter": {
"tiltGrowsUp": false,
"iterationCount": 1000,
"samplesCount": 200,
"supportHeight": false,
"panGrowsClockwise": false,
"cameraIteratorParameters": [
{
"minValue": "NaN",
"cameraParameterType": "X",
"maxValue": "NaN",
"value": 1.29295170697E7
},
{
"minValue": "NaN",
"cameraParameterType": "Y",
"maxValue": "NaN",
"value": 3279448.7247
},
{
"minValue": 0,
"cameraParameterType": "Z",
"maxValue": 80,
"value": "NaN"
},
{
"minValue": "NaN",
"cameraParameterType": "FOV_X",
"maxValue": "NaN",
"value": "NaN"
},
{
"minValue": "NaN",
"cameraParameterType": "FOV_Y",
"maxValue": "NaN",
"value": "NaN"
}
]
},
"videoParameterList": [
{
"videoWidth": 1540,
"calibrationModel": {
"isRansac": false,
"centerY": 0,
"centerX": 0,
"calibrationModelType": 0,
"calibrationPoints": [
{
"spatialPoint": {
"x": 1.2929429979064863E7,
"y": 3279405.072826336,
"z": 0
},
"videoPoint": {
"x": 546,
"y": 196
}
},
{
"spatialPoint": {
"x": 1.2929372108815093E7,
"y": 3279432.230745163,
"z": 0
},
"videoPoint": {
"x": 855,
"y": 445
}
},
{
"spatialPoint": {
"x": 1.2929376742628248E7,
"y": 3279481.6986007923,
"z": 0
},
"videoPoint": {
"x": 1281,
"y": 414
}
},
{
"spatialPoint": {
"x": 1.2929298549258841E7,
"y": 3279409.595201617,
"z": 0
},
"videoPoint": {
"x": 694,
"y": 590
}
},
{
"spatialPoint": {
"x": 1.2929325804647576E7,
"y": 3279495.6764664766,
"z": 0
},
"videoPoint": {
"x": 1244,
"y": 534
}
},
{
"spatialPoint": {
"x": 1.2929358878926704E7,
"y": 3279505.9148433916,
"z": 0
},
"videoPoint": {
"x": 1409,
"y": 456
}
},
{
"spatialPoint": {
"x": 1.2929424599934718E7,
"y": 3279463.9504835536,
"z": 0
},
"videoPoint": {
"x": 1273,
"y": 217
}
},
{
"spatialPoint": {
"x": 1.2929371030474676E7,
"y": 3279383.6257988643,
"z": 0
},
"videoPoint": {
"x": 432,
"y": 448
}
}
],
"fovX": 0,
"fovY": 0,
"isIntrinsic": false,
"isExtrinsic": false,
"cameraLocation": {
"cameraRoll": -0.7656412825751551,
"cameraYaw": -90.89065135311759,
"cameraY": 3279448.7247,
"cameraZ": 65.78334160898069,
"cameraX": 1.29295170697E7,
"cameraPitch": -39.80838777192129
}
},
"clipRegion": {
"center": {
"x": 770,
"y": 385
},
"parts": [5],
"style": null,
"prjCoordSys": null,
"id": 0,
"type": "REGION",
"partTopo": [1],
"points": [
{
"x": 0,
"y": 0
},
{
"x": 1540,
"y": 0
},
{
"x": 1540,
"y": 770
},
{
"x": 0,
"y": 770
},
{
"x": 0,
"y": 0
}
]
},
"zoom": 1,
"time": 0,
"validBounds": {
"OUT_TOP": 2,
"OUT_RIGHT": 4,
"size": {
"width": 1540,
"height": 770
},
"x": 0,
"width": 1540,
"y": 0,
"OUT_BOTTOM": 8,
"location": {
"x": 0,
"y": 0
},
"OUT_LEFT": 1,
"height": 770
},
"tilt": 23.9,
"pan": 156,
"videoHeight": 770
},
{
"videoWidth": 1540,
"calibrationModel": {
"isRansac": false,
"centerY": 0,
"centerX": 0,
"calibrationModelType": 0,
"calibrationPoints": [
{
"spatialPoint": {
"x": 1.2929429979064863E7,
"y": 3279405.072826336,
"z": 0
},
"videoPoint": {
"x": 120,
"y": 126
}
},
{
"spatialPoint": {
"x": 1.2929371395548986E7,
"y": 3279432.6098156744,
"z": 0
},
"videoPoint": {
"x": 410,
"y": 442
}
},
{
"spatialPoint": {
"x": 1.2929377985228604E7,
"y": 3279478.5103589036,
"z": 0
},
"videoPoint": {
"x": 820,
"y": 444
}
},
{
"spatialPoint": {
"x": 1.2929298549258841E7,
"y": 3279409.595201617,
"z": 0
},
"videoPoint": {
"x": 228,
"y": 564
}
},
{
"spatialPoint": {
"x": 1.292926073318682E7,
"y": 3279503.7847872227,
"z": 0
},
"videoPoint": {
"x": 735,
"y": 641
}
},
{
"spatialPoint": {
"x": 1.2929358878926704E7,
"y": 3279505.9148433916,
"z": 0
},
"videoPoint": {
"x": 947,
"y": 504
}
},
{
"spatialPoint": {
"x": 1.2929424599934718E7,
"y": 3279463.9504835536,
"z": 0
},
"videoPoint": {
"x": 859,
"y": 262
}
},
{
"spatialPoint": {
"x": 1.2929388108285695E7,
"y": 3279545.695535939,
"z": 0
},
"videoPoint": {
"x": 1324,
"y": 465
}
},
{
"spatialPoint": {
"x": 1.2929322376055904E7,
"y": 3279573.704751997,
"z": 0
},
"videoPoint": {
"x": 1183,
"y": 579
}
}
],
"fovX": 0,
"fovY": 0,
"isIntrinsic": false,
"isExtrinsic": false,
"cameraLocation": {
"cameraRoll": -0.7656412825751551,
"cameraYaw": -70.89065135311759,
"cameraY": 3279448.7247,
"cameraZ": 65.78334160898069,
"cameraX": 1.29295170697E7,
"cameraPitch": -39.80838777192129
}
},
"clipRegion": {
"center": {
"x": 770,
"y": 385
},
"parts": [5],
"style": null,
"prjCoordSys": null,
"id": 0,
"type": "REGION",
"partTopo": [1],
"points": [
{
"x": 0,
"y": 0
},
{
"x": 1540,
"y": 0
},
{
"x": 1540,
"y": 770
},
{
"x": 0,
"y": 770
},
{
"x": 0,
"y": 0
}
]
},
"zoom": 1,
"time": 12.733333333333333,
"validBounds": {
"OUT_TOP": 2,
"OUT_RIGHT": 4,
"size": {
"width": 1540,
"height": 770
},
"x": 0,
"width": 1540,
"y": 0,
"OUT_BOTTOM": 8,
"location": {
"x": 0,
"y": 0
},
"OUT_LEFT": 1,
"height": 770
},
"tilt": 23.9,
"pan": 136,
"videoHeight": 770
},
{
"videoWidth": 1540,
"calibrationModel": {
"isRansac": false,
"centerY": 0,
"centerX": 0,
"calibrationModelType": 0,
"calibrationPoints": [
{
"spatialPoint": {
"x": 1.292947775352481E7,
"y": 3279486.5758288642,
"z": 0
},
"videoPoint": {
"x": 1111,
"y": 52
}
},
{
"spatialPoint": {
"x": 1.2929377985228604E7,
"y": 3279478.5103589036,
"z": 0
},
"videoPoint": {
"x": 374,
"y": 420
}
},
{
"spatialPoint": {
"x": 1.292926073318682E7,
"y": 3279503.7847872227,
"z": 0
},
"videoPoint": {
"x": 263,
"y": 611
}
},
{
"spatialPoint": {
"x": 1.2929358878926704E7,
"y": 3279505.9148433916,
"z": 0
},
"videoPoint": {
"x": 491,
"y": 499
}
},
{
"spatialPoint": {
"x": 1.2929424599934718E7,
"y": 3279463.9504835536,
"z": 0
},
"videoPoint": {
"x": 448,
"y": 248
}
},
{
"spatialPoint": {
"x": 1.2929388108285695E7,
"y": 3279545.695535939,
"z": 0
},
"videoPoint": {
"x": 860,
"y": 506
}
},
{
"spatialPoint": {
"x": 1.2929407825861763E7,
"y": 3279565.077638886,
"z": 0
},
"videoPoint": {
"x": 1046,
"y": 497
}
},
{
"spatialPoint": {
"x": 1.2929445928769993E7,
"y": 3279564.7923564096,
"z": 0
},
"videoPoint": {
"x": 1269,
"y": 418
}
}
],
"fovX": 0,
"fovY": 0,
"isIntrinsic": false,
"isExtrinsic": false,
"cameraLocation": {
"cameraRoll": -0.7656412825751551,
"cameraYaw": -50.89065135311759,
"cameraY": 3279448.7247,
"cameraZ": 65.78334160898069,
"cameraX": 1.29295170697E7,
"cameraPitch": -39.80838777192129
}
},
"clipRegion": {
"center": {
"x": 770,
"y": 385
},
"parts": [5],
"style": null,
"prjCoordSys": null,
"id": 0,
"type": "REGION",
"partTopo": [1],
"points": [
{
"x": 0,
"y": 0
},
{
"x": 1540,
"y": 0
},
{
"x": 1540,
"y": 770
},
{
"x": 0,
"y": 770
},
{
"x": 0,
"y": 0
}
]
},
"zoom": 1,
"time": 23.266666666666666,
"validBounds": {
"OUT_TOP": 2,
"OUT_RIGHT": 4,
"size": {
"width": 1540,
"height": 770
},
"x": 0,
"width": 1540,
"y": 0,
"OUT_BOTTOM": 8,
"location": {
"x": 0,
"y": 0
},
"OUT_LEFT": 1,
"height": 770
},
"tilt": 23.9,
"pan": 116,
"videoHeight": 770
}
],
"parameterInterpolation": false
},
"fieldNames": [
"SMID",
"SMUSERID"
],
"name": "ptz旋转画面.mp4",
"startTime": "2023/11/22 09:16:51",
"geometry": {
"center": {
"x": 1.292926198036702E7,
"y": 3279399.5618885513
},
"parts": [5],
"style": null,
"prjCoordSys": null,
"id": 1,
"type": "REGION",
"partTopo": [1],
"points": [
{
"x": 1.2929466274270147E7,
"y": 3279386.794475903
},
{
"x": 1.2929463599646807E7,
"y": 3279488.8953134995
},
{
"x": 1.2929031336155694E7,
"y": 3279642.3491254174
},
{
"x": 1.292908470565614E7,
"y": 3279156.774651685
},
{
"x": 1.2929466274270147E7,
"y": 3279386.794475903
}
]
},
"endTime": "2023/11/22 09:16:58",
"fieldValues": [
"1",
"0"
],
"ID": 1,
"cameraLocation": {
"cameraRoll": -0.7656412825751551,
"cameraYaw": -90.89065135311759,
"cameraY": 3279448.7247,
"cameraZ": 65.78334160898069,
"cameraX": 1.29295170697E7,
"cameraPitch": -39.80838777192129
}
}],
"featureUriList": [],
"datasetInfos": [{
"fieldInfos": [
{
"name":
"SmID",
"caption": "SmID",
"type": "INT32"
},
{
"name": "SmUserID",
"caption": "SmUserID",
"type": "INT32"
}
],
"featureRange": {
"start": 0,
"end": 0
},
"datasetName": "NewDatasource:ptz旋转画面_2"
}],
"totalCount": 1,
"featureCount": 1
}
返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。
HEAD 请求可以用来判断 featureResults 资源是否存在，或者客户端是否有权限访问 featureResults 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 featureResults 资源是否支持<format>格式的表述。