Tiler Statistics - Get All

Referencia

Servicio:: Planetary Computer

Versión de la API:: 2025-04-30-preview

Estadísticas de activos fusionados.

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

Con parámetros opcionales:

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}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
collectionId	path	True	string maxLength: 500 pattern: .*	Identificador de colección STAC
itemId	path	True	string maxLength: 500 pattern: .*	Identificador de artículo STAC
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.
asset_as_band	query		boolean	Activo como banda
assetBidx	query		string[]	Índices por banda de activos (índices separados por comas)
assets	query		string[]	Nombres de los activos.
c	query		string[]	Lista de valores para los que se van a notificar recuentos.
categorical	query		boolean	Estadísticas devueltas para el conjunto de datos categórico.
expression	query		string	Expresión matemática de banda entre activos
histogram_bins	query		string	Define el número de bins de igual ancho en el rango especificado (10, de forma predeterminada). Si bins es una secuencia (valores delimitados por comas `,` ), define una matriz de bordes de bin que aumenta monótonamente, incluido el borde más a la derecha, lo que permite anchos de bin no uniformes. enlace: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
histogram_range	query		string	Rango delimitado por comas `,` de los contenedores. El rango inferior y superior de los contenedores. Si no se proporciona, el rango es simplemente (a.min(), a.max()). Los valores fuera del rango se ignoran. El primer elemento del rango debe ser menor o igual que el segundo. El rango también afecta al cálculo automático de la ubicación. enlace: https://numpy.org/doc/stable/reference/generated/numpy.histogram.html
max_size	query		integer (int32)	Dimensión máxima en píxeles para los datos de origen utilizados para calcular estadísticas
nodata	query		number (float)	Sobrescribir el valor interno de Nodata
p	query		integer[]	Lista de valores de percentil (el valor predeterminado es [2, 98]).
resampling	query		Resampling	Método de remuestreo.
unscale	query		boolean	Aplicar escala interna o desplazamiento

Respuestas

Nombre	Tipo	Description
200 OK	StatisticsResponse	La solicitud se ha realizado correctamente.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Nombre

Tipo

Description

200 OK

StatisticsResponse

La solicitud se ha realizado correctamente.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Una respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

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

Ejemplos

TilerStatistics_GetAll

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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
  }
}

Definiciones

Nombre	Description
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
BandStatistics	Información estadística sobre una banda de datos.
Resampling	Algoritmo de remuestreo que se utilizará al leer datos ráster de origen a diferentes resoluciones

Azure.Core.Foundations.Error

Object

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Una representación en lenguaje natural del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Object

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Object

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

BandStatistics

Object

Información estadística sobre una banda de datos.

Nombre	Tipo	Description
count	number (float)	Recuento de píxeles en la banda.
histogram	number[] (float)	Histograma de los valores de píxel en la banda.
majority	number (float)	Valor más común en la banda.
masked_pixels	number (float)	Recuento de píxeles enmascarados en la banda.
max	number (float)	Valor máximo en la banda.
mean	number (float)	Valor medio de la banda.
median	number (float)	Valor mediano de la banda.
min	number (float)	Valor mínimo en la banda.
minority	number (float)	Valor mínimo común en la banda.
percentile_2	number (float)	Percentil 2 El valor del percentil 2.
percentile_98	number (float)	Percentil 98 El valor del percentil 98.
std	number (float)	Desviación estándar de los valores de píxel en la banda.
sum	number (float)	Suma de todos los valores de píxel de la banda.
unique	number (float)	Recuento de valores únicos en la banda.
valid_percent	number (float)	Porcentaje de píxeles válidos (no enmascarados).
valid_pixels	number (float)	Recuento de píxeles válidos (no enmascarados) en la banda.

Resampling

Enumeración

Algoritmo de remuestreo que se utilizará al leer datos ráster de origen a diferentes resoluciones

Valor	Description
average	Remuestreo promedio: calcula la media de todos los píxeles contribuyentes
bilinear	Interpolación bilineal: calcula los valores de salida utilizando un promedio ponderado de celdas de entrada de 2x2
cubic	Interpolación cúbica: utiliza un promedio ponderado de celdas de entrada de 4x4 para obtener resultados más suaves
cubic_spline	Interpolación de spline cúbica: similar a la cúbica, pero conserva mejor los bordes
gauss	Remuestreo ponderado gaussiano: aplica una ponderación gaussiana a los píxeles contribuyentes
lanczos	Remuestreo sinc con ventana de Lanczos: alta calidad con artefactos mínimos
mode	Remuestreo de modo: selecciona el valor más común de los píxeles contribuyentes
nearest	Vecino más cercano: método más rápido que selecciona el valor de píxel más cercano
rms	Remuestreo de raíz cuadrática media: útil para remuestrear cuadrículas de error o desviación

Compartir a través de

Tiler Statistics - Get All

Parámetros de identificador URI

Respuestas

Seguridad

OAuth2Auth

Ámbitos

Ejemplos

TilerStatistics_GetAll

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

BandStatistics

Resampling