Mosaic Items Asset Statistics - Get All

Služba:: Planetary Computer

Verze rozhraní API:: 2026-04-15

Statistiky předmětů
Statistiky podle assetu pro položku STAC.

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

S volitelnými parametry:

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}&collection={collection}&asset_expression={asset_expression}&height={height}&width={width}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
collectionId	path	True	string maxLength: 500 pattern: .*	Identifikátor kolekce STAC
endpoint	path	True	string (uri)	GeoCatalog endpoint, např. `https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com`
itemId	path	True	string maxLength: 500 pattern: .*	Identifikátor položky STAC
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
asset_bidx	query		string[]	Indexy podle skupin aktiv (indexy oddělené kómou, např. "image\|1,2,3" znamená použít pásma 1, 2 a 3 z aktiva s názvem "image")
asset_expression	query		string[]	Podle výrazu asset band.
assets	query		string[]	Názvy datových zdrojů.
bidx	query		integer[]	Indexy datových souborů
c	query		integer[]	Seznam kategorických hodnot pixelů, pro které se hlásí počty.
categorical	query		boolean	Vraťte statistiky pro kategoriální datovou sadu.
collection	query		string	Identifikátor kolekce STAC
crs	query		string	Souřadnicový referenční systém.
datetime	query		string	Datum pro použití pro podnastavení assetu.
height	query		integer (int32)	Vysílejte výšku obrazu jako výstup.
histogram_bins	query		string	Definuje počet binů stejné šířky v daném rozsahu (10, ve výchozím nastavení). Pokud je bins sekvence (hodnoty oddělené čárkou `,` ), definuje monotónně rostoucí pole hran binů, včetně pravé hrany, což umožňuje nerovnoměrné šířky binů. Odkaz: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
histogram_range	query		string	Rozsah binů vymezený čárkou `,` . Dolní a horní rozsah boxů. Pokud není uvedeno, rozsah je jednoduše (a.min(), a.max()). Hodnoty mimo rozsah jsou ignorovány. První prvek rozsahu musí být menší nebo roven druhému. Dosah ovlivňuje i automatické počítání binů. Odkaz: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
max_size	query		integer (int32)	Maximální rozměr v pixelech pro zdrojová data používaná k výpočtu statistiky
nodata	query		string	Přepsat interní hodnotu Nodata
p	query		integer[]	Seznam percentilových hodnot (výchozí [2, 98]).
reproject	query		WarpKernelResampling	WarpKernel algoritmus pro převzorkování (používá se pouze při reprojekci). Výchozí hodnota je `nearest`.
resampling	query		Resampling	Metoda převzorkování.
sel	query		string[]	Indexování pomocí Xarray pomocí jmen `{dimension}={value}`dimenzí .
sel_method	query		SelMethod	Metoda indexování v Xarray pro nepřesné shody.
subdataset_bands	query		integer[]	Index pásma poddatasetu uvnitř assetu.
subdataset_name	query		string	Název poddatasetu uvnitř assetu.
unscale	query		boolean	Použití interního měřítka nebo odsazení
width	query		integer (int32)	Vynuťte šířku obrazu výstupu.

Odpovědi

Name	Typ	Description
200 OK	AssetStatisticsResponse	Požadavek byl úspěšný.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Name

Typ

Description

200 OK

AssetStatisticsResponse

Požadavek byl úspěšný.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Neočekávaná chybová odpověď

Hlavičky

x-ms-error-code: string

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

MosaicItemsAssetStatistics_GetAll

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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
    }
  }
}

Definice

Name	Description
Azure.Core.Foundations.Error	Objekt chyby.
Azure.Core.Foundations.ErrorResponse	Odpověď obsahující podrobnosti o chybě.
Azure.Core.Foundations.InnerError	Objekt obsahující konkrétnější informace o chybě. Podle Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.
Resampling	Převzorkovací algoritmus pro použití při čtení zdrojových rastrových dat v různých rozlišeních
SelMethod	Metoda indexování v Xarray pro použití pro nepřesné shody
WarpKernelResampling	WarpKernel resampling algoritmus používaný při reprojekci. Výchozí hodnota je `nearest`.

Azure.Core.Foundations.Error

Objekt

Objekt chyby.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
details	Azure.Core.Foundations.Error[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror	Azure.Core.Foundations.InnerError	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	Azure.Core.Foundations.Error	Objekt chyby.

Azure.Core.Foundations.InnerError

Objekt

Objekt obsahující konkrétnější informace o chybě. Podle Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
innererror	Azure.Core.Foundations.InnerError	Vnitřní chyba.

Resampling

Výčet

Převzorkovací algoritmus pro použití při čtení zdrojových rastrových dat v různých rozlišeních

Hodnota	Description
nearest	Nejbližší soused - nejrychlejší metoda, která vybere nejbližší hodnotu pixelu
bilinear	Bilineární interpolace - vypočítá výstupní hodnoty pomocí váženého průměru 2x2 vstupních buněk
cubic	Kubická interpolace - používá vážený průměr vstupních buněk 4x4 pro hladší výsledky
cubic_spline	Kubická interpolace spline - podobná kubické, ale lépe zachovává hrany
lanczos	Lanczosovo okenní převzorkování sinc - vysoce kvalitní s minimem artefaktů
average	Průměrné převzorkování - vypočítá průměr všech přispívajících pixelů
mode	Režim převzorkování - vybírá nejběžnější hodnotu z přispívajících pixelů
gauss	Gaussovské vážené převzorkování - aplikuje Gaussovské vážení na přispívající obrazové body
rms	Převzorkování střední kvadratické hodnoty - vhodné pro převzorkování chyb nebo odchylek mřížek

SelMethod

Výčet

Metoda indexování v Xarray pro použití pro nepřesné shody

Hodnota	Description
nearest	Metoda nejbližšího souseda
linear	Lineární interpolace
bilinear	Bilineární interpolace
cubic	Kubická interpolace
cubic_spline	Kubická interpolace spline
lanczos	Lanczosova interpolace
area	Interpolace vážená podle plochy
mode	Hodnota režimu (nejčastější)

WarpKernelResampling

Výčet

WarpKernel resampling algoritmus používaný při reprojekci. Výchozí hodnota je nearest.

Hodnota	Description
nearest	Nejbližší soused
bilinear	Bilineární interpolace
cubic	Kubická interpolace
cubic_spline	Kubická interpolace spline
lanczos	Lanczosovo oknové sinc převzorkování
average	Průměrné převzorkování
mode	Resampling módů
max	Maximální hodnotové převzorkování
min	Minimální hodnota převzorkování
med	Střední převzorkování
q1	Převzorkování v prvním kvartilu
q3	Resampling třetího kvartilu
sum	Součtové převzorkování
rms	Resampling podle kořenové střední čtvercové metody