Mosaic Items Asset Statistics - Get All

Serviço:: Planetary Computer

Versão da API:: 2026-04-15

Estatísticas de Ativos de Itens
Por estatística de ativo para um item STAC.

GET {endpoint}/data/mosaic/collections/{collectionId}/items/{itemId}/asset_statistics?api-version=2026-04-15

Com parâmetros opcionais:

GET {endpoint}/data/mosaic/collections/{collectionId}/items/{itemId}/asset_statistics?api-version=2026-04-15&bidx={bidx}&assets={assets}&asset_bidx={asset_bidx}&nodata={nodata}&unscale={unscale}&reproject={reproject}&resampling={resampling}&max_size={max_size}&categorical={categorical}&c={c}&p={p}&histogram_bins={histogram_bins}&histogram_range={histogram_range}&subdataset_name={subdataset_name}&subdataset_bands={subdataset_bands}&crs={crs}&datetime={datetime}&sel={sel}&sel_method={sel_method}&asset_expression={asset_expression}&height={height}&width={width}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
collectionId	path	True	string maxLength: 500 pattern: .*	Identificador da Coleção STAC
endpoint	path	True	string (uri)	Endpoint GeoCatalog, por exemplo, `https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com`
itemId	path	True	string maxLength: 500 pattern: .*	Identificador de Item STAC
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.
asset_bidx	query		string[]	Índices de banda por ativo (índices separados por coma, por exemplo, "image\|1,2,3" significa usar as bandas 1, 2 e 3 do ativo chamado "image")
asset_expression	query		string[]	Por expressão da banda de ativos.
assets	query		string[]	Nomes de ativos.
bidx	query		integer[]	Índices de banda de conjunto de dados
c	query		integer[]	Lista de valores categóricos de pixels para os quais reportar as contagens.
categorical	query		boolean	Retorne estatísticas para conjunto de dados categóricos.
crs	query		string	Sistema de Referência de Coordenadas.
datetime	query		string	Data para usar para subconfiguração do ativo.
height	query		integer (int32)	Forçar a saída da altura da imagem.
histogram_bins	query		string	Define o número de bins de largura igual na faixa dada (10, por padrão). Se bins for uma sequência (valores delimitados por `,` vírgula), ele define um array monotonamente crescente de arestas de bins, incluindo a aresta mais à direita, permitindo larguras de bin não uniformes. link: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
histogram_range	query		string	A vírgula `,` delimita o alcance das caixas. A faixa inferior e superior das caixas. Se não for fornecido, o alcance é simplesmente (a.min(), a.max()). Valores fora da faixa são ignorados. O primeiro elemento do intervalo deve ser menor ou igual ao segundo. O alcance também afeta o cálculo automático da caixa. link: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
max_size	query		integer (int32)	Dimensão máxima em pixels para os dados de origem usados para calcular estatísticas
nodata	query		string	Substituir o valor interno do Nodata
p	query		integer[]	Lista de valores percentuais (padrão para [2, 98]).
reproject	query		WarpKernelResampling	Algoritmo de reamostragem WarpKernel (usado apenas ao fazer reprojeção). Usa `nearest` como padrão.
resampling	query		Resampling	Método de reamostragem.
sel	query		string[]	Indexação Xarray usando nomes `{dimension}={value}`de dimensão .
sel_method	query		SelMethod	Método de indexação Xarray para usar em correspondências imprecisas.
subdataset_bands	query		integer[]	O índice de uma faixa de subconjunto dentro do ativo.
subdataset_name	query		string	O nome de um subconjunto de dados dentro do ativo.
unscale	query		boolean	Aplicar escala ou deslocamento interno
width	query		integer (int32)	Forçar a largura da imagem de saída.

Respostas

Nome	Tipo	Description
200 OK	AssetStatisticsResponse	A solicitação foi bem-sucedida.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Uma resposta de erro inesperada. Cabeçalhos x-ms-error-code: string

Nome

Tipo

Description

200 OK

AssetStatisticsResponse

A solicitação foi bem-sucedida.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Uma resposta de erro inesperada.

Cabeçalhos

x-ms-error-code: string

Segurança

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
https://geocatalog.spatio.azure.com/.default

Exemplos

MosaicItemsAssetStatistics_GetAll

Solicitação de exemplo

HTTP

GET {endpoint}/data/mosaic/collections/naip-atl/items/ga_m_3308421_se_16_060_20211114/asset_statistics?api-version=2026-04-15&assets=image

Resposta de exemplo

Código de status:: 200

{
  "image": {
    "b1": {
      "min": 11,
      "max": 246,
      "mean": 122.09540892575887,
      "count": 893952,
      "sum": 109147435,
      "std": 60.36645444129488,
      "median": 125,
      "majority": 209,
      "minority": 244,
      "unique": 234,
      "histogram": [
        [
          61766,
          117028,
          110859,
          87913,
          83879,
          103424,
          111240,
          97825,
          97615,
          22403
        ],
        [
          11,
          34.5,
          58,
          81.5,
          105,
          128.5,
          152,
          175.5,
          199,
          222.5,
          246
        ]
      ],
      "valid_percent": 100,
      "masked_pixels": 0,
      "valid_pixels": 893952,
      "percentile_2": 26,
      "percentile_98": 226
    },
    "b2": {
      "min": 38,
      "max": 245,
      "mean": 144.07083825529782,
      "count": 893952,
      "sum": 128792414,
      "std": 48.5299357729891,
      "median": 149,
      "majority": 166,
      "minority": 38,
      "unique": 206,
      "histogram": [
        [
          30430,
          78066,
          95120,
          104046,
          104894,
          114066,
          140175,
          110035,
          94264,
          22856
        ],
        [
          38,
          58.7,
          79.4,
          100.1,
          120.8,
          141.5,
          162.2,
          182.9,
          203.6,
          224.29999999999998,
          245
        ]
      ],
      "valid_percent": 100,
      "masked_pixels": 0,
      "valid_pixels": 893952,
      "percentile_2": 55,
      "percentile_98": 227
    },
    "b3": {
      "min": 49,
      "max": 241,
      "mean": 128.610202784937,
      "count": 893952,
      "sum": 114971348,
      "std": 48.88558925037479,
      "median": 122,
      "majority": 81,
      "minority": 49,
      "unique": 193,
      "histogram": [
        [
          75113,
          179336,
          124008,
          84332,
          96200,
          79850,
          80252,
          105476,
          47208,
          22177
        ],
        [
          49,
          68.2,
          87.4,
          106.6,
          125.8,
          145,
          164.2,
          183.4,
          202.6,
          221.79999999999998,
          241
        ]
      ],
      "valid_percent": 100,
      "masked_pixels": 0,
      "valid_pixels": 893952,
      "percentile_2": 60,
      "percentile_98": 224
    },
    "b4": {
      "min": 0,
      "max": 244,
      "mean": 134.29559752648913,
      "count": 893952,
      "sum": 120053818,
      "std": 57.02485093862381,
      "median": 149,
      "majority": 188,
      "minority": 244,
      "unique": 244,
      "histogram": [
        [
          38157,
          65176,
          68901,
          71015,
          82329,
          110236,
          144394,
          213124,
          84507,
          16113
        ],
        [
          0,
          24.4,
          48.8,
          73.19999999999999,
          97.6,
          122,
          146.39999999999998,
          170.79999999999998,
          195.2,
          219.6,
          244
        ]
      ],
      "valid_percent": 100,
      "masked_pixels": 0,
      "valid_pixels": 893952,
      "percentile_2": 17,
      "percentile_98": 218
    }
  }
}

Definições

Nome	Description
Azure.Core.Foundations.Error	O objeto de erro.
Azure.Core.Foundations.ErrorResponse	Uma resposta que contém detalhes do erro.
Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes Azure API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Resampling	Algoritmo de reamostragem a ser usado ao ler dados raster de origem em diferentes resoluções
SelMethod	Método de indexação Xarray para usar em correspondências imprecisas
WarpKernelResampling	Algoritmo de reamostragem WarpKernel usado ao fazer reprojeção. Usa `nearest` como padrão.

Azure.Core.Foundations.Error

Objeto

O objeto de erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
details	Azure.Core.Foundations.Error[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível pelo ser humano do erro.
target	string	O destino do erro.

Azure.Core.Foundations.ErrorResponse

Objeto

Uma resposta que contém detalhes do erro.

Nome	Tipo	Description
error	Azure.Core.Foundations.Error	O objeto de erro.

Azure.Core.Foundations.InnerError

Objeto

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes Azure API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
innererror	Azure.Core.Foundations.InnerError	Erro interno.

Resampling

Enumeração

Algoritmo de reamostragem a ser usado ao ler dados raster de origem em diferentes resoluções

Valor	Description
nearest	Vizinho mais próximo - método mais rápido que seleciona o valor de pixel mais próximo
bilinear	Interpolação bilinear - calcula os valores de saída usando uma média ponderada de 2x2 células de entrada
cubic	Interpolação cúbica - usa uma média ponderada de células de entrada 4x4 para resultados mais suaves
cubic_spline	Interpolação de spline cúbica - semelhante ao cúbico, mas preserva melhor as bordas
lanczos	Lanczos windowed sinc resampling - alta qualidade com artefatos mínimos
average	Reamostragem média - calcula a média de todos os pixels contribuintes
mode	Reamostragem de modo - seleciona o valor mais comum dos pixels contribuintes
gauss	Reamostragem ponderada gaussiana - aplica uma ponderação gaussiana aos pixels contribuintes
rms	Reamostragem da raiz quadrada média - útil para reamostragem de erros ou grades de desvio

SelMethod

Enumeração

Método de indexação Xarray para usar em correspondências imprecisas

Valor	Description
nearest	Método do vizinho mais próximo
linear	Interpolação linear
bilinear	Interpolação bilinear
cubic	Interpolação cúbica
cubic_spline	Interpolação de splines cúbicas
lanczos	Interpolação de Lanczos
area	Interpolação ponderada por área
mode	Valor de modo (mais comum)

WarpKernelResampling

Enumeração

Algoritmo de reamostragem WarpKernel usado ao fazer reprojeção. Usa nearest como padrão.

Valor	Description
nearest	Vizinho mais próximo
bilinear	Interpolação bilinear
cubic	Interpolação cúbica
cubic_spline	Interpolação de splines cúbicas
lanczos	Reamostragem sinc janelado de Lanczos
average	Reamostragem média
mode	Reamostragem de modos
max	Reamostragem de valor máximo
min	Reamostragem de valor mínimo
med	Reamostragem de valores mediana
q1	Reamostragem do primeiro quartil
q3	Reamostragem do terceiro quartil
sum	Reamostragem de soma
rms	Reamostragem quadrática média raiz