<geometryInterpolation_uri>/density[.<format>]
geometryInterpolationDensityResult
The geometryInterpolationDensity resource. You can create a point density interpolation analysis result 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/density.rjson
Gets a form for the POST request.
Creates the resource of an density interpolation analysis result, i.e., performs an density interpolation analysis.
When perform the POST request, the request body should contain the following parameters:
| Name | Type | Description |
| 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 geometryInterpolationDensity resource, or submit the following request body for http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/interpolation/density.rjson:
{
"searchRadius":0,
"pixelFormat":"BIT16",
"zValueScale":1,
"resolution":3000,
"outputDatasetName":"density2",
"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_1a6cc036e1244c339cc8a93aced4235e",
"postResultType":"CreateChild",
"newResourceLocation":"http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/interpolation/density/fvmhhtsg_1a6cc036e1244c339cc8a93aced4235e"
}
Performing a GET request on http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/geometry/interpolation/density/fvmhhtsg_1a6cc036e1244c339cc8a93aced4235e.rjson can retrieve detailed information about the interpolation analysis result. Please see geometryInterpolationDensityResult.
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 geometryInterpolationDensity resource exists, or if the geometryInterpolationDensity resource can be accessed by clients. It can also determine if the geometryInterpolationDensity resource supports an output format <format> if performed on a URI with .<format> included.