你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Tiler Statistics - Get All

参考

服务:: Planetary Computer

API 版本:: 2025-04-30-preview

合并的资产统计信息。

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/statistics?api-version=2025-04-30-preview

具有可选参数:

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/statistics?api-version=2025-04-30-preview&assets={assets}&expression={expression}&assetBidx={assetBidx}&asset_as_band={asset_as_band}&nodata={nodata}&unscale={unscale}&resampling={resampling}&max_size={max_size}&categorical={categorical}&c={c}&p={p}&histogram_bins={histogram_bins}&histogram_range={histogram_range}

URI 参数

名称	在	必需	类型	说明
collectionId	path	True	string maxLength: 500 pattern: .*	STAC 集合标识符
itemId	path	True	string maxLength: 500 pattern: .*	STAC 项标识符
api-version	query	True	string minLength: 1	用于此作的 API 版本。
asset_as_band	query		boolean	资产作为带
assetBidx	query		string[]	按资产区间索引（昏迷分隔索引）
assets	query		string[]	资产的名称。
c	query		string[]	要报告计数的值列表。
categorical	query		boolean	返回分类数据集的统计数据。
expression	query		string	资产之间的波段数学表达式
histogram_bins	query		string	定义给定范围内等宽分箱的数量（默认为 10）。如果 bins 是一个序列（逗 `,` 号分隔的值），则它定义一个单调递增的 bin 边缘数组，包括最右边的 bin 边缘，从而允许非均匀的 bin 宽度。链接： https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
histogram_range	query		string	`,`以逗号分隔的 bin 范围。分箱的下限和上限范围。如果未提供，则 range 只是（a.min（）， a.max（））。超出范围的值将被忽略。范围的第一个元素必须小于或等于第二个元素。 range 也会影响自动 bin 计算。链接： https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
max_size	query		integer (int32)	用于计算统计数据的源数据的最大维度（以像素为单位）
nodata	query		number (float)	覆盖内部 Nodata 值
p	query		integer[]	百分位数值列表（默认为 [2， 98]）。
resampling	query		Resampling	重新采样方法。
unscale	query		boolean	应用内部缩放或偏移

响应

名称	类型	说明
200 OK	StatisticsResponse	请求已成功。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	意外的错误响应。标头 x-ms-error-code: string

名称

类型

说明

200 OK

StatisticsResponse

请求已成功。

Other Status Codes

Azure.Core.Foundations.ErrorResponse

意外的错误响应。

标头

x-ms-error-code: string

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
https://geocatalog.spatio.azure.com/.default

示例

TilerStatistics_GetAll

示例请求

HTTP

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{{collectionId}}/items/{{itemId}}/statistics?api-version=2025-04-30-preview

示例响应

状态代码:: 200

{
  "data_b1": {
    "min": 0,
    "max": 0,
    "mean": 0,
    "count": 100,
    "sum": 0,
    "std": 0,
    "median": 0,
    "majority": 0,
    "minority": 0,
    "unique": 1,
    "histogram": [
      [
        0,
        0,
        0,
        0,
        0,
        100,
        0,
        0,
        0,
        0
      ],
      [
        -0.5,
        -0.4,
        -0.3,
        -0.19999999999999996,
        -0.09999999999999998,
        0,
        0.10000000000000009,
        0.20000000000000007,
        0.30000000000000004,
        0.4,
        0.5
      ]
    ],
    "valid_percent": 100,
    "masked_pixels": 0,
    "valid_pixels": 100,
    "percentile_2": 0,
    "percentile_98": 0
  }
}

定义

名称	说明
Azure.Core.Foundations.Error	错误对象。
Azure.Core.Foundations.ErrorResponse	包含错误详细信息的响应。
Azure.Core.Foundations.InnerError	包含有关错误的更具体信息的对象。根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。
BandStatistics	有关数据带区的统计信息。
Resampling	以不同分辨率读取源栅格数据时使用的重采样算法

Azure.Core.Foundations.Error

Object

错误对象。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
details	Azure.Core.Foundations.Error[]	导致此报告错误的特定错误的详细信息数组。
innererror	Azure.Core.Foundations.InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	有关错误的可读的表示形式。
target	string	错误的目标。

Azure.Core.Foundations.ErrorResponse

Object

包含错误详细信息的响应。

名称	类型	说明
error	Azure.Core.Foundations.Error	错误对象。

Azure.Core.Foundations.InnerError

Object

包含有关错误的更具体信息的对象。根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
innererror	Azure.Core.Foundations.InnerError	内部错误。

BandStatistics

Object

有关数据带区的统计信息。

名称	类型	说明
count	number (float)	波段中的像素计数。
histogram	number[] (float)	波段中像素值的直方图。
majority	number (float)	区间中最常见的值。
masked_pixels	number (float)	波段中被遮罩像素的计数。
max	number (float)	区间中的最大值。
mean	number (float)	区间的平均值。
median	number (float)	区间的中值。
min	number (float)	带中的最小值。
minority	number (float)	带区中的最小公值。
percentile_2	number (float)	百分位数 2 第 2 个百分位数值。
percentile_98	number (float)	百分位数 98 第 98 个百分位数值。
std	number (float)	波段中像素值的标准差。
sum	number (float)	波段中所有像素值的总和。
unique	number (float)	带区中唯一值的计数。
valid_percent	number (float)	有效（未蒙版）像素的百分比。
valid_pixels	number (float)	波段中有效（未被遮罩）像素的计数。

Resampling

枚举

以不同分辨率读取源栅格数据时使用的重采样算法

值	说明
average	平均重采样 - 计算所有参与像素的平均值
bilinear	双线性插值 - 使用 2x2 输入像元的加权平均值计算输出值
cubic	三次插值 - 使用 4x4 输入单元格的加权平均值以获得更平滑的结果
cubic_spline	三次样条插值 - 类似于三次，但更好地保留了边缘
gauss	高斯加权重新采样 - 将高斯加权应用于参与像素
lanczos	Lanczos 窗口 sinc 重采样 - 高质量，最少的伪影
mode	模式重新采样 - 从贡献像素中选择最常见的值
nearest	最邻近 - 选择最接近像素值的最快方法
rms	均方根重采样 - 用于重采样误差或偏差网格

通过

Tiler Statistics - Get All

URI 参数

响应

安全性

OAuth2Auth

作用域

示例

TilerStatistics_GetAll

示例请求

示例响应

定义

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

BandStatistics

Resampling