geometryInterpolationDensity


URI

<geometryInterpolation_uri>/density[.<format>]

Supported methods

GET, POST, HEAD

Parent resource

geometryInterpolation

Child resources

geometryInterpolationDensityResult

Introduction

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.

Resource hierarchy

HTTP request methods

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

GET request

Gets a form for the POST request.

POST request

Creates the resource of an density interpolation analysis result, i.e., performs an density interpolation analysis.

Request parameter

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.

Response structure

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.

Response example

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.

HEAD request

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.

See