imageService

方法概述

方法详细说明

computeAngles(url, parameters, requestOptions){Promise<ImageAngleResult>}

起始版本：GeoScene Maps SDK for JavaScript 4.22

计算 ImageryLayer 在给定位置处的旋转角度。此操作在 3.1 及更高版本中受支持。

参数

url String 表示影像服务的 GeoScene Server REST 资源的 URL。

parameters ImageAngleParameters autocast 自动转换自 Object 指定用于计算角度的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<ImageAngleResult>	解析后，返回包含计算的北角和向上角的 ImageAngleResult 实例。

另请参阅

• GeoScene REST API - 计算角度

computeHistograms(url, parameters, requestOptions){Promise<object>}

基于提供的 ImageHistogramParameters 计算直方图。如果未指定栅格函数和镶嵌规则，则将使用图层上的当前设置。 此操作的结果包含根据给定范围计算的直方图。

参数

url String 表示影像服务的 GeoScene Server REST 资源的 URL。

parameters ImageHistogramParameters autocast 自动转换自 Object 指定用于计算直方图的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<Object>	解析为包含直方图结果的对象。有关详细信息，请参阅下面的对象规范表。 属性 类型 描述 histograms[] RasterHistogram 包含栅格直方图的结果。

computePixelSpaceLocations(url, parameters, requestOptions){Promise<ImagePixelLocationResult>}

起始版本：GeoScene Maps SDK for JavaScript 4.22

基于输入几何计算 ImageryLayer 列和行中的相应像素位置。需要栅格目录项目具有有效的 icsToPixel 资源。

参数

url String 表示影像服务的 GeoScene Server REST 资源的 URL。

parameters ImagePixelLocationParameters 指定用于计算影像空间像素位置的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<ImagePixelLocationResult>	解析后，返回 ImagePixelLocationResult 的实例，其中包含每个输入几何的列和行的 x 和 y 值。

computeStatisticsHistograms(url, parameters, requestOptions){Promise<object>}

为提供的 ImageHistogramParameters 计算 statistics 和 histograms。如果未指定栅格函数和镶嵌规则，则将使用图层上的当前设置。 此操作的结果包含根据给定范围计算的统计信息和直方图。

参数

url String 表示影像服务的 GeoScene Server REST 资源的 URL。

parameters ImageHistogramParameters autocast 自动转换自 Object 指定用于计算统计信息和直方图的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<Object>	解析为包含直方图和统计信息结果的对象。有关详细信息，请参阅下面的对象规范表。 属性 类型 描述 histograms[] RasterHistogram 包含栅格直方图的结果。 bandStatistics[] RasterBandStatistics 栅格波段统计。

getSamples(url, parameters, requestOptions){Promise<ImageSampleResult>}

起始版本：GeoScene Maps SDK for JavaScript 4.23

返回给定几何的采样点位置、像素值和源数据的相应分辨率。当输入几何是 polyline、extent 或 polygon 时，采样将基于 sampleCount 或 sampleDistance 参数。当几何为 point 或 multipoint 时，直接使用点或多点。

响应中的样本位置数基于 sampleDistance 或 sampleCount 参数，并且不能超过影像服务施加的限制。样本点位于提供的几何和栅格项目轮廓线的交点处。它们也由 mosaicRule 和 pixelSize 参数进行过滤。

参数

url String 表示影像服务的 GeoScene Server REST 资源的 URL。

parameters ImageSampleParameters autocast 自动转换自 Object getSamples 操作中使用的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<ImageSampleResult>	解析后，返回包含 ImageSamples 数组的 ImageSampleResult。

示例

// get all sample points along a polyline
// at the specified sample distance and pixel size
const param = {
  geometry: polyline
  returnFirstValueOnly: false,
  // resolution - unit of the view's spatial reference
  pixelSize: {
    x:12,
    y:12,
    spatialReference: view.spatialReference
  },
  interpolation: "nearest",
  // unit of the geometry's spatial reference is used
  sampleDistance: 30,
  outFields: ["*"]
};
imageService.getSamples(url, param).then((results) => {
  // use the getSamples results as needed.
  console.log(results);
})
.catch(function(error){
  console.log(error)
})

identify(url, params, requestOptions){Promise<ImageIdentifyResult>}

向 GeoScene REST 影像服务资源发送请求，以根据 params 参数中指定的 ImageIdentifyParameters 来识别内容。

参数

url String 表示影像服务的 GeoScene Server REST 资源的 URL。

params ImageIdentifyParameters 指定用于标识要素的条件。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<ImageIdentifyResult>	解析后，返回 ImageIdentifyResult 的实例。

measureAreaAndPerimeter(url, parameters, requestOptions){Promise<ImageAreaResult>}

起始版本：GeoScene Maps SDK for JavaScript 4.26

计算影像服务上给定几何的面积和周长。此操作的结果包括所使用的栅格数据集的名称、传感器名称和测量值。

参数

url String 执行面积测量和周长测量的影像服务的 url。

parameters ImageAreaParameters autocast 自动转换自 Object 指定用于测量影像服务上给定几何的面积和周长的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<ImageAreaResult>	解析后，将返回一个 ImageAreaResult 实例，其中包含所使用的栅格数据集的名称、传感器名称和测量值。

measureDistanceAndAngle(url, parameters, requestOptions){Promise<ImageDistanceResult>}

起始版本：GeoScene Maps SDK for JavaScript 4.26

计算影像服务上两点之间的距离和角度。此操作的结果包括所使用的栅格数据集的名称、传感器名称和测量值。

参数

url String 执行距离测量和角度测量的影像服务的 url。

parameters ImageDistanceParameters autocast 自动转换自 Object 指定用于测量影像上两点之间的距离和角度的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<ImageDistanceResult>	解析后，将返回一个 ImageDistanceResult 实例，其中包含所使用的栅格数据集的名称、传感器名称和测量值。

measureHeight(url, parameters, requestOptions){Promise<ImageHeightResult>}

起始版本：GeoScene Maps SDK for JavaScript 4.26

计算影像服务上两点之间对象的高度。此操作的结果包括所使用的栅格数据集的名称、传感器名称和测量值。请参阅 ImageHeightParameters.operationType 文档以了解高度测量的类型。

参数

url String 执行高度测量的影像服务的 url。

parameters ImageHeightParameters autocast 自动转换自 Object 指定用于测量影像服务上两点之间对象高度的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<ImageHeightResult>	解析后，将返回一个 ImageHeightResult 实例，其中包含所使用的栅格数据集的名称、传感器名称和测量值。

measurePointOrCentroid(parameters, requestOptions){Promise<ImagePointResult>}

起始版本：GeoScene Maps SDK for JavaScript 4.26

返回影像服务上给定点的位置或给定区域的质心。

参数

parameters ImagePointParameters autocast 自动转换自 Object 指定用于确定影像服务上给定区域的点位置或质心的参数。

requestOptions Object optional 用于数据请求的附加选项（将覆盖构造期间定义的 requestOptions）。

返回

类型	描述
Promise<ImagePointResult>	解析后，将返回一个 ImagePointResult 实例，其中包含所使用的栅格数据集的名称、传感器名称和测量值。