<map_uri>/queryresults[.<format>]
queryResults 资源表示查询结果的集合，通过该资源可以对地图（{mapName}）进行 SQL 查询、距离查询、空间查询、最近地物查询、范围查询以及海图查询等。
关于本资源的相关使用示例请参考：SQL 查询、关联表 SQL 查询、距离查询。
支持的方法：
支持的表述格式：RJSON、JSON、HTML、XML、GeoJSON、FlatGeobuf。
注：查询的图层为点、线、面数据集类型时，GeoJSON表述可用。
对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名，“世界地图”是地图名（{mapName}），URI 表示一个“世界地图” 的查询集合。
http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/queryResults.rjson
获取查询结果的集合，即已创建的 queryResult 资源表述集合。
| 名称 | 类型 | 含义 |
| _cache | boolean | 【可选参数】
是否使用缓存，默认为 true。如果为 false，则关闭所有缓存。 |
对 queryResults 资源执行 GET 请求得到的是 queryResult 资源信息的集合，集合中的每一个元素的结构如下：
| 字段 | 类型 | 说明 |
| name | String | queryResult 资源的名称。 |
| path | String | queryResult 资源的访问路径。 |
| resourceConfigID | String | 资源配置项 ID。 |
| resourceType | String | 资源类型。 |
| supportedMediaTypes | String[] | 数据源资源支持的表述的媒体类型。 |
在一次成功的查询（即对 queryResults 成功执行 POST 请求）后，queryResults 资源里保存了查询结果的信息，对 queryResults 资源执行 GET 请求，返回 rjson 格式的资源描述如下：
[{
"name": "1",
"path": "http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/queryResults/1.rjson",
"resourceConfigID": null,
"resourceType": "ArithResultResource",
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/rjson",
"text/html"
]
}]
按照给定参数创建一个地图查询的结果资源，其中 returnContent 必须包含在 URI 中。
通过对 queryResults 资源执行 POST 请求，可以进行 SQL 查询、距离查询、空间查询、最近地物查询、范围查询等，由 queryMode 参数来指定进行的是哪种查询模式，不同查询模式用到的查询参数也不一样。其中，URI 中的参数为可选参数。
URI 中的参数如下：
| 名称 | 类型 | 含义 |
| returnContent | boolean | 是否立即返回新创建资源的表述还是返回新资源的 URI，默认为 false。
如果为 true，则直接返回新创建资源，即查询结果的表述。如果为 false，则返回的是查询结果资源的 URI。 |
| withIndex | boolean | 当使用 FlatGeobuf 表述时该参数可选。表示返回的表述为 FlatGeobuf 的结果是否包含空间索引，默认为true。 |
| returnCustomResult | boolean | 是否返回查询结果的 Bounds 信息，当 returnContent=false 时有效。
如果为 true，返回查询结果的 Bounds 信息（响应结构中的 customResult 字段）。 如果为 false，则不返回 Bounds 信息。默认为 false。 |
其中，对 queryResults 执行 POST 请求时，如果 returnContent 为 true，将直接得到查询结果资源（queryResult）的表述；如果 returnContent 为 false，将得到结果资源（queryResult 资源）的 URI，对该结果资源执行 GET 操作，可得到需要的结果。
请求体中的参数如下：
| 名称 | 类型 | 含义 | |
queryMode |
QueryMode | 【必选参数】
查询的模式，有 SQL 查询、距离查询、空间查询、最近地物查找、范围查询以及海图查询等几种类型。其中：
|
|
| queryParameters | QueryParameterSet | 【必选参数】 属性查询的参数集合，包含了查询参数数组（queryParams）、期望返回的结果记录数（expectCount）、查询起始记录位置（startRecord）、查询结果选项对象（queryOption）等，详情请参考 QueryParameterSet。 其中，查询参数数组（queryParams）包含要查询的图层的名称（name）、查询字段数组（fields）、SQL 查询属性过滤条件（attributeFilter）、分组条件（groupBy）、查询 id 数组（ids）、连接查询项数组（joinItems）、关联外部表（linkItems）、SQL 查询排序的字段（orderBy）等信息。 注意：1.部分查询模式，不支持所有的查询参数，详情如右单元格。 2.当设置关联查询（linkItems）参数时，如果设置的关联表中的字段不存在，则可能没有查询结果。 |
距离查询：不支持查询参数数组（queryParams）中的fields、ids、name、groupBy、orderBy、joinItems、linkItems等 注意：当查询模式为距离查询，且查询结果数大于期望返回的结果记录数（expectCount）时，距离查询结果为从查询总记录中随机抽取的 expectCount 个地物。 |
范围查询：不支持查询参数数组（queryParams）中的fields、ids、name、groupBy、orderBy、joinItems、linkItems等 |
|||
最近地物查找：不支持查询参数数组（queryParams）中的fields、ids、name、groupBy、orderBy、joinItems、linkItems等，不支持查询起始记录位置（startRecord）参数。 注意：当查询模式为最近地物查找，且查询结果数大于期望返回的结果记录数（expectCount）时，最近地物查找结果为查询总记录中距离中心最近的 expectCount 个地物，这 expectCount 个地物为无序排列。 |
|||
空间查询：不支持 groupBy 字段，否则可能导致空间查询的结果不正确。 |
|||
SQL 查询时： 注意：1.当查询模式为 SQL 查询时，如果在系统配置文件（参见：iServer 配置文件说明）中设置了 SQL 查询表达式中需要屏蔽掉的字符串，那么在 SQL 查询过滤条件（attributeFilter）中一旦发现输入了已经设置的字符串，系统会认为该条查询表达式非法并返回400参数异常，防止 SQL 注入。如果在系统配置文件中没有设置 SQL 查询表达式中需要屏蔽掉的字符串，那么在 SQL 查询过滤条件（attributeFilter）中会默认屏蔽掉分号。 2.当查询模式为 SQL 查询，查询的数据量较大，且存储在 PostGIS、PostgreSQL、MySQL 等空间数据库中时，如果该数据库支持空间几何函数查询，您还可以在查询参数中，如：查询字段数组（fields）、SQL 查询属性过滤条件（attributeFilter）等写入空间几何函数，利用空间数据库进行计算，从而缓解 iServer 计算压力，提高返回结果的速度。请求体示例参见 示例6 SQL查询-以空间几何函数为条件 |
|||
| geometry | Geometry | queryMode 为距离查询或空间查询时必选。
空间对象信息。geometry 的投影坐标系与地图坐标系相同。 |
|
| bounds | Rectangle2D | queryMode 为范围查询时必选。
查询指定图层落在该范围内的记录。bounds 的投影坐标系与地图坐标系相同。 |
|
| spatialQueryMode | SpatialQueryMode | queryMode 为空间查询时必选。
空间查询操作模式。 有包含、交叉、分离、重合、相交、叠加、 邻接、被包含等。 |
|
| distance | double | queryMode 为距离查询或最近地物查询时必选。distance 的单位与地图坐标单位相同。
距离查询时，表示距离地物的距离。最近地物查询时，表示搜索的范围。 |
|
| 名称 | 类型 | 含义 |
| queryMode | QueryMode | 【必选参数】海图查询，有两种模式：海图属性查询（ChartAttributeQuery）和海图范围查询（ChartBoundsQuery）。 |
| chartLayerNames | String | 【必选参数】待查询的图层名。 |
| chartQueryParameters | ChartQueryParameterSet | 【必选参数】海图查询参数集合（数组）。 |
| bounds | Rectangle2D | 【必选参数】指定的查询范围，当查询模式为 ChartBoundsQuery 时必选。 |
关键字查询
| 名称 | 类型 | 含义 |
| queryMode | QueryMode | 【必选参数】关键字查询（KeywordsQuery）。 |
keywordsQueryParameters |
KeywordsQueryParameterSet | 【必选参数】关键字查询参数集合。 |
对 queryResults 资源执行 POST 请求，进行查询，创建查询结果资源。
在 returnContent=false 的情况下，返回操作结果的表述如下：
| 字段 | 类型 | 说明 |
| succeed | boolean | 查询是否成功。 |
| newResourceID | String | 查询结果资源的 ID。 |
| postResultType | postResultType | POST 请求的结果类型。 说明 POST 请求对目标资源的影响，即处理结果是什么样的。 |
| newResourceLocation | String | 创建的新资源的 URI。 |
| customResult | Object | 返回查询结果的 Bounds 信息。
如果地图设置了动态投影，返回的 Bounds 的投影坐标系与地图坐标系相同。 如果地图没有设置动态投影，返回的 Bounds 的投影坐标系与查询结果所在的数据集的投影坐标系相同。 |
在 returnContent=true 的情况下，返回的表述中没有 newResourceLocation 字段，取而代之的是 newResourceLocation 所标识的资源，即 queryResult 资源的表述。请参见 queryResult 资源表述的结构。
注意，queryResult 的表述中，查询记录集中的字段信息由 Recordset 中的 fields 字段记录。每个 Feature 中的 fieldNames 字段均为 null。
对 queryResults 资源：http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/queryResults.rjson?returnCustomResult=true，执行如下参数的 POST 请求，对 World 地图进行 SQL 查询：
{
"queryMode": "SqlQuery",
"bounds": {
"leftBottom": {
"x": 0,
"y": 0
},
"rightTop": {
"x": 100,
"y": 100
}
},
"distance": 1,
"queryParameters": {
"queryParams": [{
"attributeFilter": "SMID %26gt; 0",
"name": "ContinentLabel@World"
}],
"startRecord": 0,
"expectCount": 20,
"networkType": "LINE",
"queryOption": "ATTRIBUTEANDGEOMETRY"
},
"spatialQueryMode": "INTERSECT"
}
返回 rjson 格式的资源描述如下：
{
"succeed": true,
"newResourceID": "iypwfdzf_91c24c622e9641e18a808ae8a89f698b",
"postResultType": "CreateChild",
"customResult": {
"rightTop": {
"y": 55.98430295074347,
"x": 140.7362260537166
},
"leftBottom": {
"y": -82.49592439558907,
"x": -119.53556537446983
},
"bottom": -82.49592439558907,
"left": -119.53556537446983,
"right": 140.7362260537166,
"top": 55.98430295074347
},
"newResourceLocation": "http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/queryResults/iypwfdzf_91c24c622e9641e18a808ae8a89f698b.json"
}
对 "http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/queryResults/1.rjson” 执行 GET 请求，即获取查询的具体结果。请参见 queryResult 的 GET 请求。
对 queryResults 资源：http://supermapiserver:8090/iserver/services/map-World/rest/maps/世界地图/queryResults.geojson?returnCustomResult=true，执行如下参数的 POST 请求，对 World 地图进行 SQL 查询：
{
"queryMode": "SqlQuery",
"bounds": {
"leftBottom": {
"x": 0,
"y": 0
},
"rightTop": {
"x": 100,
"y": 100
}
},
"distance": 1,
"queryParameters": {
"queryParams": [{
"attributeFilter": "SMID %26gt; 0",
"name": "Capitals@World"
}],
"startRecord": 0,
"expectCount": 1,
"networkType": "LINE",
"queryOption": "ATTRIBUTEANDGEOMETRY"
},
"spatialQueryMode": "INTERSECT"
}
返回 geojson 格式的资源描述如下：
{
"features":[
{
"geometry":{
"coordinates":[-47.8977476573595,-15.792110943058866],
"type":"Point"
},
"id":"1",
"type":"Feature",
"properties":{
"SmGeometrySize":"16",
"CAP_POP":"2207718.0",
"COUNTRY_CH":"巴西",
"CAPITAL_EN":"Brasilia",
"POP":"2207718.0",
"CAPITAL_CH":"巴西利亚",
"SMID":"1",
"COUNTRY":"巴西",
"CAPITAL_LO":"Brasília",
"COUNTRY_EN":"Brazil",
"SmUserID":"0",
"USERID":"0",
"SMY":"-15.792110943058866",
"SMX":"-47.8977476573595",
"SMUSERID":"0",
"CAPITAL":"巴西利亚",
"SmLibTileID":"1"
}
}],
"type":"FeatureCollection"
}
对 queryResults 资源：http://localhost:8090/iserver/services/map-China100/rest/maps/China/queryResults.json，执行如下参数的 POST 请求，对 Airport_pt@China#1 图层进行多字段分组统计：
{
"queryMode": "SqlQuery",
"bounds": {
"leftBottom": {
"x": 0,
"y": 0
},
"rightTop": {
"x": 100,
"y": 100
}
},
"distance": 1,
"queryParameters": {
"queryParams": [
{
"name": "Airport_pt@China#1",
"fields":["min(GB) as minANGLE","max(ANGLE) as maxSmGeometrySize","SUM(GB) as SUMSmGeometrySize","SUM(ANGLE) as sumAngle"],
"groupBy":"NAME"
}
],
"startRecord": 0,
"expectCount": 40,
"networkType": "LINE",
"queryOption": "ATTRIBUTEANDGEOMETRY"
},
"keywords": "",
"spatialQueryMode": "INTERSECT"
}
其中，queryParams 查询参数数组包含要查询的图层的名称（name）、查询字段数组（fields）、分组条件（groupBy）。
返回 rjson 格式的资源描述如下：
{
"postResultType": "CreateChild",
"newResourceID": "6ea0d91a10224b6dbdbf0215df433e26_56f2a45c75d742d4a793255a6e1959fa",
"succeed": true,
"newResourceLocation": "http://localhost:8090/iserver/services/map-China100/rest/maps/China/queryResults/6ea0d91a10224b6dbdbf0215df433e26_56f2a45c75d742d4a793255a6e1959fa.json"
}
对 "http://localhost:8090/iserver/services/map-China100/rest/maps/China/queryResults/6ea0d91a10224b6dbdbf0215df433e26_56f2a45c75d742d4a793255a6e1959fa.json” 执行 GET 请求，即获取查询的具体结果。请参见 queryResult 的 GET 请求。
请求体示例：
{
"queryMode": "BoundsQuery",
"bounds": {
"leftBottom": {
"x": 112.35,
"y": 34.6
},
"rightTop": {
"x": 112.4,
"y": 34.62
}
},
"distance": 1,
"queryParameters": {
"queryParams": [{
"attributeFilter": "SMID > 0",
"name": "testCAD@test1"
}],
"startRecord": 0,
"expectCount": 20,
"networkType": "LINE",
"queryOption": "ATTRIBUTEANDGEOMETRY"
},
"keywords": "",
"spatialQueryMode": "INTERSECT"
}
响应结果示例：
{
"customResult": {
"bottom": 34.54666099978054,
"left": 112.26249133678498,
"leftBottom": {
"x": 112.26249133678498,
"y": 34.54666099978054
},
"right": 112.48668999981291,
"rightTop": {
"x": 112.48668999981291,
"y": 34.72305325426654
},
"top": 34.72305325426654
},
"newResourceID": "62599fc42ee044c7acea57b5e8d9bc87_9bfbea897ac3473fa75728ed0880f8fb",
"newResourceLocation": "http://server:8090/iserver/services/map-henan/rest/maps/luoyang/queryResults/62599fc42ee044c7acea57b5e8d9bc87_9bfbea897ac3473fa75728ed0880f8fb.rjson",
"postResultType": "CreateChild",
"succeed": true
}
对 queryResults 资源：http://supermapiserver:8090/iserver/services/map-demo/rest/maps/map_hbase/queryResults.rjson?returnCustomResult=true，执行如下参数的 POST 请求，对分布式数据地图使用 ECQL 语言进行查询，请求体中的参数示例如下：
{
"queryMode": "SqlQuery",
"queryParameters": {
"queryParams": [{
"attributeFilter": "BBOX(the_geom,103 ,17 ,119 ,27)",
"name": "Muifa_4326@map_hbase"
}],
"startRecord": 0,
"expectCount": 20,
"queryOption": "ATTRIBUTEANDGEOMETRY"
},
}
返回 rjson 格式的操作结果表述如下：
[{
"resourceConfigID": null,
"supportedMediaTypes": [
"application/xml",
"text/xml",
"application/json",
"application/fastjson",
"application/rjson",
"text/html",
"application/jsonp",
"application/x-java-serialized-object",
"image/bmp",
"image/gif",
"image/jpeg",
"image/jpg",
"image/png",
"image/webp",
"application/geojson"
],
"path": "http://localhost:8090/iserver/services/map-demo/rest/maps/ map_hbase/queryResults/3899fc437cd748e1b60b92aa87083f54_af3b0f0dcc1248a8b7c57029b783fbfc.rjson",
"name": "3899fc437cd748e1b60b92aa87083f54_af3b0f0dcc1248a8b7c57029b783fbfc",
"resourceType": "ArithResultResource"
}]
对 http://localhost:8090/iserver/services/map-demo/rest/maps/ map_hbase/queryResults/3899fc437cd748e1b60b92aa87083f54_af3b0f0dcc1248a8b7c57029b783fbfc.rjson 执行 GET 请求，即获取查询的具体结果:
{
"recordsets": [
{
"datasetName": "Muifa_4326",
"features": [
{
"fieldNames": [],
"ID": 0,
"fieldValues": [],
"geometry": {
"id": 0,
"center": {
"y": 24.1,
"x": 132.8
},
"style": null,
"parts": [
1
],
"partTopo": [],
"points": [
{
"y": 24.1,
"x": 132.8
}
],
"type": "POINT"
}
},
{
"fieldNames": [],
"ID": 0,
"fieldValues": [],
"geometry": {
"id": 0,
"center": {
"y": 24.4,
"x": 131.4
},
"style": null,
"parts": [
1
],
"partTopo": [],
"points": [
{
"y": 24.4,
"x": 131.4
}
],
"type": "POINT"
}
},
{
"fieldNames": [],
"ID": 0,
"fieldValues": [],
"geometry": {
"id": 0,
"center": {
"y": 24.3,
"x": 132.1
},
"style": null,
"parts": [
1
],
"partTopo": [],
"points": [
{
"y": 24.3,
"x": 132.1
}
],
"type": "POINT"
}
}
],
"fieldCaptions": [],
"fieldTypes": [],
"fields": []
}
],
"totalCount": 3,
"currentCount": 3,
"customResponse": null
}
返回 rjson 格式的资源描述如下：
{
"postResultType": "CreateChild",
"newResourceID": "3bd49e762198498aa7ce26d6dbde94bd_a17b2f68d6e949f88a2af296a36c70e9",
"succeed": true,
"customResult": {
"top": 0,
"left": 0,
"bottom": 0,
"leftBottom": {
"x": 0,
"y": 0
},
"right": 0,
"rightTop": {
"x": 0,
"y": 0
}},
"newResourceLocation": "http://lsupermapiserver:8090/iserver/services/map-postgisMap/rest/maps/postgisMap/queryResults/3bd49e762198498aa7ce26d6dbde94bd_a17b2f68d6e949f88a2af296a36c70e9.rjson"
}
返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。
HEAD 请求可以用来判断 queryResults 地图资源是否存在，或者客户端是否有权限访问 queryResults 地图资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 queryResults 地图资源是否支持<format>格式的表述。