<geometryInterpolation_uri>/rbf[.<format>]
geometryInterpolationRBFResult
The geometryInterpolationRBF resource. You can create a geometryInterpolationRBFResult resource by sending POST request to the resource.
Supported Methods:
Supported output formats: rjson, json, html, xml.
Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.
http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/interpolation/rbf.rjson
Gets a form for the POST request.
Creates the resource of an Radial Basis Function interpolation analysis result, i.e., performs an interpolation kriging analysis.
When perform the POST request, the request body should contain the following parameters:
| Name | Type | Description |
| smooth | double |
Smooth coefficient, the range is 0-1. The value commonly use are 0, 0.001, 0.01, 0.1 and 0.5. This value represent the the degree of closeness of the the interpolation function curve and the point. |
| tension | double |
Tension coefficient, the default value is 40, the commonly used values are 0, 1, 5 and 10. Used to adjust the characteristics of the result raster data surface, the greater the tension the less the effect on the results. |
| searchMode | SearchMode | When performing interpolation operation, the mode to search the point used in the operation, fixed point number search, fixed distance query and block query are supported. |
| pixelFormat | PixelFormat | Specify the pixel format of the result raster dataset,it can be: BIT16, BIT32, DOUBLE, SINGLE, UBIT1, UBIT4, UBIT8, UBIT24 or UBIT32. |
| zValueScale | double |
The zoom ratio used in interpolation analysis. The default value is 1. Specifies the zoom scale of the values to be interpolated. |
| resolution | double |
The resolution of the interpolation result raster dataset, that is the actual distance represented by a pixel. The value can't be larger than the bound side length of the discrete point series to analyze. When setting this value, it is needed to consider the size of the point dataset, commonly, the number of rows and column should be no more than 500. |
| searchRadius | double | [Fixed distance query] Search radius, that is the search extent. When calculating the Z value of a location, use the location as the center of a circle, the search extent as the radius, the points that falls in the extent will be used in the calculating. This value can be set based on the distribution of the point data and bounds of the discrete point series. |
| expectedCount | int |
[Fixed point number query] Set the number of points to query, the default is 12. |
| maxPointCountForInterpolation | int |
[Block query] The sum total of the points in the interpolation in block search, the default is 200. |
| maxPointCountInNode | int |
[Block query] The maximum point number in a single block to used in the operation, the default is 50. |
| outputDatasetName | String | The name of the interpolation analysis result dataset. |
| outputDatasourceName | String | The name of the interpolation analysis result datasource. |
| inputPoints | Point3D[] | The coordinates (including Z values) of the discrete points to perform interpolation analysis. |
| bounds | Rectangle2D | The bounds for interpolation analysis, which will be used to determine the bounds of the result grid dataset. The default is the bounds of the discrete point series. |
| clipParam | ClipParameter | The parameters used to clip the interpolation result. |
Normal response code(s): 201. The response parameters are as follows:
| Field | Type | Description |
| succeed | boolean | Whether the query 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. |
Suppose we implement the POST request on the geometryInterpolationRBF resource, or submit the following request body for http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/interpolation/rbf.rjson:
{
"smooth":0.1,
"tension":40,
"searchMode":"QUADTREE",
"maxPointCountForInterpolation":20,
"maxPointCountInNode":5,
"pixelFormat":"BIT16",
"zValueScale":1,
"resolution":3000,
"outputDatasetName":"rbf",
"outputDatasourceName":"Interpolation",
"inputPoints":[{"z":-3, "y":5846399.011754164, "x":1210581.346513096}, {"z":-2, "y":5806144.683668519, "x":1374568.1968855715}, {"z":0, "y":5770737.831291649, "x":1521370.8530005363}, {"z":-1, "y":5528199.929583105, "x":1095631.459772168}, {"z":-3, "y":5570741.490646067, "x":1198626.2178598372}, {"z":0, "y":5593290.502553593, "x":1373169.3807736137}, {"z":1, "y":5627352.642284978, "x":1612502.8281910105}, {"z":0, "y":5411257.388322545, "x":1081393.2452306528}, {"z":1, "y":5458415.294482666, "x":1369469.8846276255}, {"z":1, "y":5476577.894029853, "x":1479703.1555390327}, {"z":1, "y":5538359.532668987, "x":1625450.5930904327}, {"z":2, "y":5322253.555958582, "x":874680.7560980343}, {"z":0, "y":5387691.351356046, "x":1247212.6046764243}]
}
The response information in rjson format returned is as follows:
{
"succeed":true,
"newResourceID":"fvmhhtsg_ac2d37e15e644d0c865e3ab943b65b27",
"postResultType":"CreateChild",
"newResourceLocation":"http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/interpolation/rbf/fvmhhtsg_ac2d37e15e644d0c865e3ab943b65b27"
}
Performing a GET request on http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/interpolation/rbf/fvmhhtsg_ac2d37e15e644d0c865e3ab943b65b27.rjson can retrieve detailed information about the interpolation analysis result. Please see geometryInterpolationRBFResult.
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 geometryInterpolationRBF resource exists, or if the geometryInterpolationRBF resource can be accessed by clients. It can also determine if the geometryInterpolationRBF resource supports an output format <format> if performed on a URI with .<format> included.