Tiler Asset Statistics - Get All

Referenz

Dienst:: Planetary Computer

API-Version:: 2025-04-30-preview

Statistiken pro Anlage

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

Mit optionalen Parametern:

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-Parameter

Name	In	Erforderlich	Typ	Beschreibung
collectionId	path	True	string maxLength: 500 pattern: .*	STAC-Sammlungs-Kennung
itemId	path	True	string maxLength: 500 pattern: .*	STAC-Element-Kennung
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
asset_as_band	query		boolean	Vermögenswert als Band
assetBidx	query		string[]	Indizes pro Asset-Band (durch Koma getrennte Indizes)
assets	query		string[]	Namen der Assets.
c	query		string[]	Liste der Werte, für die die Anzahl gemeldet werden soll.
categorical	query		boolean	Gibt Statistiken für kategoriale Datasets zurück.
expression	query		string	Mathematischer Bandausdruck zwischen Assets
histogram_bins	query		string	Definiert die Anzahl der Bins gleicher Breite im angegebenen Bereich (standardmäßig 10). Wenn es sich bei bins um eine Sequenz handelt (durch Kommas `,` getrennte Werte), wird ein monoton ansteigendes Array von Bin-Kanten definiert, einschließlich der äußersten rechten Kante, wodurch ungleichmäßige Bin-Breiten möglich sind. verbinden: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
histogram_range	query		string	Kommagetrennter `,` Bereich der Klassen. Der untere und obere Bereich der Behälter. Wenn nicht angegeben, ist range einfach (a.min(), a.max()). Werte außerhalb des Bereichs werden ignoriert. Das erste Element des Bereichs muss kleiner oder gleich dem zweiten sein. Der Bereich wirkt sich auch auf die automatische Bin-Berechnung aus. verbinden: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
max_size	query		integer (int32)	Maximale Dimension in Pixel für die Quelldaten, die zum Berechnen von Statistiken verwendet werden
nodata	query		number (float)	Interner Nodata-Wert überschreiben
p	query		integer[]	Liste der Perzentilwerte (Standardwert ist [2, 98]).
resampling	query		Resampling	Resampling-Methode.
unscale	query		boolean	Wenden Sie die interne Skalierung oder den Versatz an

Antworten

Name	Typ	Beschreibung
200 OK	AssetStatisticsResponse	Geben Sie die Statistiken des Datensatzes zurück.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

AssetStatisticsResponse

Geben Sie die Statistiken des Datensatzes zurück.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Unerwartete Fehlerantwort.

Header

x-ms-error-code: string

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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

Beispiele

TilerAssetStatistics_GetAll

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 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
    }
  }
}

Definitionen

Name	Beschreibung
AssetStatisticsResponse	Geben Sie die Statistiken des Datensatzes zurück.
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Microsoft One-API-Richtlinien – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
BandStatistics	Statistische Informationen über ein Datenband.
Resampling	Resampling-Algorithmus, der beim Lesen von Quell-Raster-Daten mit unterschiedlichen Auflösungen verwendet werden soll

AssetStatisticsResponse

Objekt

Geben Sie die Statistiken des Datensatzes zurück.

Name	Typ	Beschreibung
data	<string, BandStatistics>	Antwort Asset Statistics Api Sammlungen Sammlung ID Elemente Element ID Asset Statistik Abrufen Antwort Asset Statistics Api Sammlungen Sammlung ID Elemente Element ID Asset Statistik Abrufen

Azure.Core.Foundations.Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine normal lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Microsoft One-API-Richtlinien – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

BandStatistics

Objekt

Statistische Informationen über ein Datenband.

Name	Typ	Beschreibung
count	number (float)	Anzahl der Pixel im Band.
histogram	number[] (float)	Histogramm der Pixelwerte im Band.
majority	number (float)	Häufigster Wert in der Bandbreite.
masked_pixels	number (float)	Anzahl der maskierten Pixel im Band.
max	number (float)	Maximaler Wert im Band.
mean	number (float)	Mittelwert des Bandes.
median	number (float)	Medianwert des Bandes.
min	number (float)	Mindestwert im Band.
minority	number (float)	Kleinster gemeinsamer Wert in der Band.
percentile_2	number (float)	Perzentil 2 Der Wert des 2. Perzentils.
percentile_98	number (float)	Perzentil 98 Der Wert des 98. Perzentils.
std	number (float)	Standardabweichung der Pixelwerte im Band.
sum	number (float)	Summe aller Pixelwerte im Band.
unique	number (float)	Anzahl der eindeutigen Werte im Band.
valid_percent	number (float)	Prozentsatz der gültigen (nicht maskierten) Pixel.
valid_pixels	number (float)	Anzahl der gültigen (nicht maskierten) Pixel im Band.

Resampling

Enumeration

Resampling-Algorithmus, der beim Lesen von Quell-Raster-Daten mit unterschiedlichen Auflösungen verwendet werden soll

Wert	Beschreibung
average	Durchschnittliches Resampling - berechnet den Mittelwert aller beitragenden Pixel
bilinear	Bilineare Interpolation - berechnet die Ausgabewerte anhand eines gewichteten Durchschnitts von 2x2 Eingabezellen
cubic	Kubische Interpolation - verwendet einen gewichteten Durchschnitt von 4x4 Eingabezellen für glattere Ergebnisse
cubic_spline	Kubische Spline-Interpolation - ähnlich wie kubisch, aber Kanten besser erhalten
gauss	Gaußscher gewichteter Resampling - wendet eine Gaußsche Gewichtung auf beitragende Pixel an
lanczos	Lanczos Windowed Sinc Resampling - hochwertig mit minimalen Artefakten
mode	Modus-Resampling - wählt den gebräuchlichsten Wert aus den beitragenden Pixeln aus
nearest	Nächster Nachbar - schnellste Methode, die den nächstgelegenen Pixelwert auswählt
rms	Root Mean Square Resampling - nützlich für Resampling-Fehler- oder Abweichungsgitter

Freigeben über

Tiler Asset Statistics - Get All

URI-Parameter

Antworten

Sicherheit

OAuth2Auth

Bereiche

Beispiele

TilerAssetStatistics_GetAll

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AssetStatisticsResponse

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

BandStatistics

Resampling