Tiler Asset 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}/asset_statistics?api-version=2025-04-30-preview

С использованием необязательных параметров:

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/asset_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 — это последовательность (значения, разделенные `,` запятыми), она определяет монотонно увеличивающийся массив краев ячеек, включая крайний правый край, что позволяет использовать ячейки неравномерной ширины. связь: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
histogram_range	query		string	Запятая `,` разделяет диапазон ячеек. Нижняя и верхняя линейка бункеров. Если не указано, диапазон просто (a.min(), a.max()). Значения за пределами диапазона игнорируются. Первый элемент диапазона должен быть меньше или равен второму. Диапазон также влияет на автоматический расчет ячейки. связь: 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	AssetStatisticsResponse	Возвращает статистику набора данных.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Имя

Тип

Описание

200 OK

AssetStatisticsResponse

Возвращает статистику набора данных.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Непредвиденное сообщение об ошибке.

Заголовки

x-ms-error-code: string

Безопасность

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://geocatalog.spatio.azure.com/.default

Примеры

TilerAssetStatistics_GetAll

Образец запроса

HTTP

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{{collectionId}}/items/{{itemId}}/asset_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
    }
  }
}

Определения

Имя	Описание
AssetStatisticsResponse	Возвращает статистику набора данных.
Azure.Core.Foundations.Error	Объект ошибки.
Azure.Core.Foundations.ErrorResponse	Ответ, содержащий сведения об ошибке.
Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по API Microsoft One — https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
BandStatistics	Статистическая информация о полосе данных.
Resampling	Алгоритм пересчета для использования при чтении исходных растровых данных с разными разрешениями

AssetStatisticsResponse

Object

Возвращает статистику набора данных.

Имя	Тип	Описание
data	<string, BandStatistics>	Ответ Статистика активов API Коллекции Идентификатор коллекции Элементы Идентификатор элемента Статистика активов Получить Ответ Статистика активов API Коллекции Идентификатор коллекции Элементы Идентификатор элемента Статистика активов Получить

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

Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по API Microsoft One — 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	Nearest neighbor - самый быстрый метод, который выбирает ближайшее значение пикселя
rms	Среднеквадратичная пересчет - полезен для сетки ошибок или отклонений при повторной выборке

Поделиться через

Tiler Asset Statistics - Get All

Параметры URI

Ответы

Безопасность

OAuth2Auth

Области

Примеры

TilerAssetStatistics_GetAll

Образец запроса

Пример ответа

Определения

AssetStatisticsResponse

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

BandStatistics

Resampling