URI1：<dataset_uri>/isoregion[.<format>]
URI2：<dataset_uri>/isoregion/{zValuedFieldName}/{resolution}[.<format>]
Isoregions can be extracted from a raster dataset or a point dataset. When isoregions are extracted from a raster dataset, parameters filterQueryParameter, zValueFieldName, and resolution are not needed. URI2 can also be used to extract isoregions on a point dataset. In this case, zValueFile and resolution passed in the URL.
Supported Methods:
Supported output formats: rjson, json, html, xml.
http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/isoregion
Gets a form for the POST request.
Performing a POST request on the resource with related parameters creates the resource of a surface analysis result, i.e., performs a surface analysis for extracting isoregion.
Parameters in the URI:
| Name | Type | Description |
| asynchronousReturn | boolean | Whether to employ asynchronous operation or not. If true, returns the URI of the new resource immediately after the client submits the request (returnContent setting doesn't work); if false, the server returns the description or the URI of the new resource URI according to the returnContent settings after analysis. The default is false. |
| returnContent | boolean | Returns the description or the URI of the new resource. If true, returns the description for the analysis result. If false, returns the URI. The default is false. |
URI1 is used to extract isoregions from a raster dataset or a point dataset. The parameters in the request body are as follows:
Among the parameters, filterQueryParameter, zValueFieldName, and resolution are not needed if a raster dataset is used.
| Name | Type | Description |
| extractParameter | ExtractParameter | The parameters for the extracting operation. |
| resultSetting | DataReturnOption | The extraction result setting. |
| filterQueryParameter | QueryParameter | The parameter for filtering the points to be interpolated. Only the points that satisfy the condition will participate in interpolation. |
| zValuedFieldName | String | The field name for the extracting operation. When extracting the isoregions, the value in this field is used for interpolating the point data in the record set. The interpolation results a raster dataset (an intermediate result) based on which the isolines are extracted for finally creating the isoregions. |
| resolution | double |
The resolution of the middle raster dataset, represent the actual distance represented by a cell, the unit is the same with resource dataset. The value range:
The recommended value: the one five hundredth of the extent of the source dataset. |
| clipRegion | Geometry | [Optional parameter] The clip region object. Use null to replace this parameter is do not need to perform clip operation. |
A URI2 with zVelueFile and resolution included is used to extract isoregions from a point dataset. The request body parameters are as follows:
| Name | Type | Description |
| parameter | ExtractParameter | Parameters for extraction. |
| filterQueryParameter | QueryParameter | The parameter for filtering the points to be interpolated. Only the points that satisfy the condition will participate in interpolation. |
|
resultSetting |
DataReturnOption | The extraction result setting. |
| clipRegion | Geometry | [Optional parameter] The clip region object. Use null to replace this parameter is do not need to perform clip operation. |
Normal response code(s): 201. The response parameters are as follows:
| Field | Type | Description |
|
succeed |
boolean | Whether the analysis is successful. |
| newResourceID | String | The ID for the analysis result resource. |
| postResultType | PostResultType |
The result type fo the POST request. |
| newResourceLocation | String | The URI of the newly created resource. |
Implement the POST request on http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/isoregion and the parameters are as follows:
{
"zValueFieldName": "AVG_TMP",
"resolution": 3000,
"filterQueryParameter": {
"attributeFilter": "",
"ids": null
},
"extractParameter": {
"datumValue": 0,
"interval": 100,
"resampleTolerance": 0,
"smoothMethod": "BSPLINE",
"smoothness": 3
},
"resultSetting": {
"dataset": "PointIsoregion",
"dataReturnMode": "DATASET_ONLY",
"expectCount": 100,
"deleteExistResultDataset": false
}
}
The returned resource description in rjson format is shown below:
{
"succeed": true,
"newResourceID": "1",
"postResultType": "CreateChild",
"newResourceLocation": "http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/isoregion/1"
}
Performing a GET request on http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP%40Interpolation/isoregion/1 can retrieve detailed information about the analysis result. Please see datasetIsoregionResult.
Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.
HEAD request can be used to check if the datasetIsoregionResults resource exists, or if the resource can be accessed by clients. It can also determine if the datasetIsoregionResults resource supports an output format <format> if performed on a URI with .<format> included.