Get Samples

geometry

(Required)

A geometry that defines the locations to be sampled. The structure of the geometry is the same as the structure of the JSON geometry objects returned by the ArcGIS REST API. Applicable geometry types are point, multipoint, polyline, polygon, and envelope. When spatialReference is omitted in the input geometry, it will be assumed to be the spatial reference of the image service.

Syntax

1
2
3
4
5
//JSON structure
geometryType=<geometryType>&geometry={geometry}

//Point simple syntax
geometryType=esriGeometryPoint&geometry=<x>,<y>

Example

1
geometryType=esriGeometryPoint&geometry={"x": -104, "y": 35.6, "spatialReference":{"wkid":4326}}

geometryType

(Required)

The type of geometry specified by the geometry parameter. The geometry type can be point, multipoint, polyline, polygon, or envelope.

Values: esriGeometryPoint | esriGeometryMultipoint | esriGeometryPolyline | esriGeometryPolygon | esriGeometryEnvelope

sampleDistance

The distance interval used to sample points from the provided path. The unit is the same as the input geometry. If neither sampleCount nor sampleDistance is provided, no densification can be done for paths (polylines), and a default sampleCount (100) is used for areas (polygons or envelopes).

Example

1
sampleDistance=1.25

sampleCount

The approximate number of sample locations from the provided path. If neither sampleCount nor sampleDistance is provided, no densification can be done for paths (polylines), and a default sampleCount (100) is used for areas (polygons or envelopes).

Example

1
sampleCount=20

mosaicRule

Specifies the mosaic rule defining the image sort order. Additional filtering can be applied to the WHERE clause and FIDs of a mosaic rule. See the mosaic rule JSON objects for the syntax and examples.

pixelSize

The raster that is visible at the specified pixel size in the mosaic dataset will be used for sampling. If pixelSize is not specified, the service's pixel size is used. The structure of the pixelSize parameter is the same as the structure of the point object returned by the ArcGIS REST API. In addition to the JSON structure, you can specify the pixel size with a simple comma-separated syntax.

returnFirstValueOnly

Indicates whether to return all values at a point, or return the first non-NoData value based on the current mosaic rule. The default is true.

Values: true | false

interpolation

Added at 10.3. The resampling method. The default is nearest neighbor.

Values: RSP_BilinearInterpolation | RSP_CubicConvolution | RSP_Majority | RSP_NearestNeighbor

outFields

Added at 10.3. The list of fields to be included in the response. This list is a comma-delimited list of field names. You can also specify the wildcard character (*) as the value of this parameter to include all the field values in the results.

Example

1
2
3
4
outFields=Salinity,Time

//Wildcard usage
outFields=*

sliceId

Added at 10.9. The slice ID of the multidimensional raster. This parameter is available if the image service uses ArcObjects11 or ArcObjectsRasterRendering as the service provider.

Syntax

1
sliceId=<slice ID>

Example

1
sliceId=1

time

Added at 10.9. The time instant or time extent of the raster to be sampled. This parameter is only valid if the image service supports time and if the image service uses ArcObjects11 or ArcObjectsRasterRendering as the service provider.

Syntax

1
2
3
4
5
//Time instant
Syntax: time=<timeInstant>

//Time extent (for time extents where <startTime> or <endTime, but not both, are null)
time=<startTime>, <endTime>

Example

1
2
3
4
5
//Time instant (1 Jan 2008 00:00:00 GMT)
time=1199145600000

//Time extent (1 Jan 2008 00:00:00 GMT to 1 Jan 2009 00:00:00 GMT)
time=1199145600000, 1230768000000

f

The response format. The default response format is html .

Values: html | json