<queryResults_uri>/{resultID}[.<format>]
queryResult 资源表示对地图查询的一个结果,在对 queryResults 执行 POST 请求的时候被创建。对 queryResult 资源({resultID})执行 GET 请求,可以获取该查询结果的表述。
查询结果可以叠加在 map 资源上显示(目前地图的 JavaScript 表述中支持该功能),便于可视化的查看查询结果的具体信息。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML、PNG、JSONP、FASTJSON、GeoJSON、FlatGeobuf。
注:查询的图层为点、线、面数据集类型时,GeoJSON表述可用。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名,"世界地图"是地图名({mapName}),ID 为1是对父资源 queryResults 进行距离查询后的结果资源,URI 表示"世界地图"的一个 ID 为 1的查询结果。
"http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/queryResults/1.json
获取查询结果资源的表述。可能是 SQL 查询、距离查询、空间查询、最近地物查询、范围查询等查询的结果。
通过对 queryResult 资源执行 GET 请求,可以获取查询的结果,可以在 URI 中包含参数,如下所示:
名称 | 类型 | 含义 |
realtime | boolean | 【可选参数】
表示是否要求查询结果是实时的。如果为 true,则重新查询一次,返回结果。如果为 false,则直接从缓存中取出结果。默认为 false。 |
withIndex | boolean | 当使用 FlatGeobuf 表述时该参数可选。表示返回的表述为 FlatGeobuf 的结果是否包含空间索引,默认为true。 |
_cache | boolean | 【可选参数】
是否使用缓存,默认为 true。如果为 false,则关闭所有缓存。 |
当对 queryResult 资源执行 GET 请求,获取图片格式的查询结果时,URI 中还可包含如下参数:
名称 | 类型 | 含义 |
useGeoCoordSys | boolean | 出图时投影坐标系统是否转为能够加载在三维场景中的地理经纬坐标。 |
rectifyViewer | boolean | 出图时是否自动校正图片大小,使之与查询结果的出图范围一致。如果为 true,则自动校正图片大小,false 则不自动校正,返回图片原始大小。 |
style | Style | 查询结果中高亮目标的风格。 |
center | Point2D | 指定地图显示的中心点。 |
scale | double | 指定地图显示的比例尺。 |
viewer | Rectangle | 指定用户显示视窗,即产生的图片的大小。 |
transparent | boolean | 地图图片是否透明。 |
viewBounds |
Rectangle2D | 指定地图的出图范围。如果不设置此参数,则出图范围为查询结果对象的 Bounds。 |
foreColor | Color | 指定地图的前景颜色。 |
backColor | Color | 指定地图的背景颜色。 |
layersID | String | 地图中要出图的临时图层集合的 ID。临时图层集通过 tempLayersSet 资源创建。 |
prjCoordSys | PrjCoordSys | 当前地图的坐标参考系统。 |
cacheEnabled | boolean | 是否使用缓存。 |
customParams | String | 自定义定义参数。
可以是任何形式组织的字符串。用户可以通过该属性传入自定义的参数。 |
rectifyType | RectifyType | 校验方式。 |
clipRegion | Geometry | 地图显示裁剪的区域。 |
clipRegionEnabled | boolean | 地图显示裁剪的区域是否有效。 |
customEntireBounds | Rectangle2D | 地图自定义边界,customEntireBoundsEnabled 为 true 时有效。 |
customEntireBoundsEnabled | boolean | 自定义地图边界是否有效。 |
angle | double | 当前地图的旋转角度。 |
antialias | boolean | 是否反走样地图。 |
backgroundStyle | Style | 地图的背景风格。 |
colorMode | MapColorMode | 地图的颜色模式。 |
markerAngleFixed | boolean | 指定点状符号的角度是否固定。 |
dynamicProjection | boolean | 是否允许地图动态投影显示。 |
maxVisibleTextSize | double | 文本的最大可见尺寸,单位为像素。 |
maxVisibleVertex | int | 最大几何对象可见节点数。
如果几何对象的节点数超过指定的个数,则超过的那部分节点不显示。 |
minVisibleTextSize | double | 文本的最小可见尺寸,单位为像素。 |
overlapDisplayed | boolean | 重叠时是否显示对象。 |
paintBackground | boolean | 是否绘制地图背景。 |
textAngleFixed | boolean | 文本角度是否固定。 |
textOrientationFixed | boolean | 文本朝向是否固定。 |
对 queryResult 资源执行 GET 请求,返回操作结果的表述如下:
字段 | 类型 | 说明 |
currentCount | int | 当次查询返回的记录数。 |
customResponse | String | 自定义操作处理的结果。 |
recordsets | Recodset[] | 查询记录集。
注意,查询记录集中的字段信息由 Recordset 中的 fields 字段记录。每个 Feature 中的 fieldNames 字段均为 null。 |
totalCount | int | 根据查询条件查询到的记录的总数。 |
如果指定图片表述格式,还可返回图片。
对 queryResult 资源(SQL 查询结果):"http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/queryResults/1.rjson?realTime=true 执行 GET 请求,返回 rjson 格式的资源描述如下:
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
获取 queryResult 资源的元数据信息。检查该 queryResult 资源是否存在,权限是否可以访问。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 queryResult 资源是否支持<format>格式的表述。