Compartir a través de


Tiler Geo Jsons - Crop Format

Recorte de Geojson
Cree una imagen a partir de una característica geojson.

POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/crop.{format}?api-version=2025-04-30-preview
POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/crop.{format}?api-version=2025-04-30-preview&assets={assets}&expression={expression}&assetBidx={assetBidx}&asset_as_band={asset_as_band}&nodata={nodata}&unscale={unscale}&algorithm={algorithm}&algorithm_params={algorithm_params}&color_formula={color_formula}&coord-crs={coord-crs}&resampling={resampling}&max_size={max_size}&height={height}&width={width}&rescale={rescale}&colormap_name={colormap_name}&colormap={colormap}&return_mask={return_mask}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
collectionId
path True

string

maxLength: 500
pattern: .*

Identificador de colección STAC

format
path True

string

maxLength: 500
pattern: .*

Formato de salida para el mosaico o la imagen (por ejemplo, png, jpeg, webp) (predeterminado: "png").

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.

algorithm
query

Algorithm

Nombre del algoritmo

algorithm_params
query

string

Parámetro del algoritmo

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.

color_formula
query

string

Fórmula Rio-Color (info: https://github.com/mapbox/rio-color)

colormap
query

string

Mapa de colores personalizado codificado en JSON

colormap_name
query

ColorMapNames

Nombre del mapa de colores

coord-crs
query

string

Sistema de referencia de coordenadas de las coordenadas de entrada. El valor predeterminado es epsg:4326.

expression
query

string

Expresión matemática de banda entre activos

height
query

integer (int32)

Altura en píxeles de la imagen de salida

max_size
query

integer (int32)

Límite de tamaño de salida de imagen si no se han establecido los límites de anchura y altura.

nodata
query

number (float)

Sobrescribir el valor interno de Nodata

resampling
query

Resampling

Método de remuestreo.

rescale
query

string[]

coma (',') delimitado Rango mínimo,máximo. Puede establecer varios tiempos para varias bandas.

return_mask
query

boolean

Agregue una máscara a los datos de salida.

unscale
query

boolean

Aplicar escala interna o desplazamiento

width
query

integer (int32)

Ancho en píxeles de la imagen de salida

Cuerpo de la solicitud

Nombre Tipo Description
body

GeoJson

Solicitud de cuerpo GeoJson.

Respuestas

Nombre Tipo Description
200 OK

file

Devuelve una imagen.

Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json"

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Una respuesta de error inesperada.

Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json"

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

TilerGeoJsons_CropFormat

Solicitud de ejemplo

POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/collectionId-0df36a74d7ed/items/item-0df36a74d7ed/crop.png?api-version=2025-04-30-preview

{
  "type": "Polygon",
  "coordinates": [
    [
      [
        -65.75386020444417,
        18.252659831448764
      ],
      [
        -65.75385878091376,
        18.252569552371305
      ],
      [
        -65.75376429311993,
        18.252570912467043
      ],
      [
        -65.75376571660163,
        18.252661191551685
      ],
      [
        -65.75386020444417,
        18.252659831448764
      ]
    ]
  ]
}

Respuesta de muestra

"PNG raw file bytes"

Definiciones

Nombre Description
Algorithm

Algoritmos compatibles para el análisis basado en índices y terrenos

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.

ColorMapNames

Mapas de color disponibles para la visualización de datos

Resampling

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

Algorithm

Algoritmos compatibles para el análisis basado en índices y terrenos

Valor Description
contours

Genera curvas de nivel de elevación

hillshade

Crea una visualización de sombreado a partir de datos de elevación

normalizedIndex

Calcula el índice de diferencia normalizado entre bandas

terrainrgb

Codifica datos de elevación en formato Mapbox TerrainRGB

terrarium

Codifica datos de elevación en formato Mapbox Terrarium RGB

Azure.Core.Foundations.Error

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

Respuesta que contiene los detalles del error.

Nombre Tipo Description
error

Azure.Core.Foundations.Error

Objeto de 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.

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.

ColorMapNames

Mapas de color disponibles para la visualización de datos

Valor Description
accent

Mapa de colores de acento: mapa de colores cualitativo con colores distintos

accent_r

Mapa de colores de acento invertido

afmhot

Mapa de colores afmhot - mapa de colores secuencial negro-rojo-amarillo-blanco

afmhot_r

Mapa de colores afmhot invertido

ai4g-lulc

Mapa de colores de AI for Good para el uso de la tierra/cobertura del suelo

alos-fnf

Mapa de colores de bosques/no bosques de ALOS

alos-palsar-mask

Mapa de colores de la máscara ALOS PALSAR

autumn

Mapa de colores de otoño - mapa de colores secuencial rojo-naranja-amarillo

autumn_r

Mapa de colores de otoño invertido

binary

Mapa de colores binario: mapa de colores simple en blanco y negro

binary_r

Mapa de colores binario invertido

blues

Mapa de colores de azules: blanco secuencial a azul oscuro

blues_r

Mapa de colores de azules invertidos

bone

Mapa de colores óseos: escala de grises con un ligero tinte azul

bone_r

Mapa de colores de hueso invertido

brbg

Mapa de colores de BrBG: marrón divergente a azul verdoso

brbg_r

Mapa de colores de BrBG invertido

brg

Mapa de colores BrG: marrón a verde divergente

brg_r

Mapa de colores de BrG invertido

bugn

Mapa de colores de BuGn: de blanco secuencial a verde oscuro

bugn_r

Mapa de colores BuGn invertido

bupu

Mapa de colores de BuPu: secuencial de blanco a morado oscuro

bupu_r

Mapa de colores de BuPu invertido

bwr

Mapa de colores de BWR: azul a rojo divergente

bwr_r

Mapa de colores de BWR invertido

c-cap

Mapa de colores C-CAP - clasificación de la cobertura del suelo

cfastie

Cfastie colormap - mapa de colores de alto contraste

chesapeake-lc-13

Mapa de colores de la cobertura del suelo de Chesapeake 13 clases

chesapeake-lc-7

Mapa de colores de la cobertura del suelo de Chesapeake 7 clases

chesapeake-lu

Mapa de colores del uso del suelo de Chesapeake

chloris-biomass

Mapa de colores de la biomasa de Chloris

cividis

Mapa de colores de Cavidis: amarillo a azul secuencial

cividis_r

Mapa de colores de cividis invertido

cmrmap

Mapa de colores CMRmap: mapa de colores perceptualmente uniforme

cmrmap_r

Mapa de colores CMRmap invertido

cool

Mapa de colores frío: secuencial de cian a magenta

cool_r

Mapa de colores fríos invertido

coolwarm

Mapa de colores cálido y frío: azul a rojo divergente

coolwarm_r

Mapa de colores fríocálido invertido

copper

Mapa de colores de cobre: negro a cobre secuencial

copper_r

Mapa de colores de cobre invertido

cubehelix

Mapa de colores de Cubehelix: negro a blanco secuencial con rotación de tono

cubehelix_r

Mapa de colores de cubehelix invertido

dark2

Mapa de colores Dark2 - mapa de colores cualitativo con colores distintos

dark2_r

Mapa de colores dark2 invertido

drcog-lulc

Mapa de colores del uso del suelo/cobertura del suelo de DRCog

esa-cci-lc

Mapa de colores de la cobertura del suelo de la ESA CCI

esa-worldcover

Mapa de colores de ESA WorldCover

flag

Mapa de colores de banderas: mapa de colores cualitativo con colores distintos

flag_r

Mapa de colores de la bandera invertida

gap-lulc

Mapa de colores de uso del suelo/cobertura del suelo GAP

gist_earth

Gist_earth mapa de colores: mapa de colores perceptualmente uniforme

gist_earth_r

Mapa de colores de gist_earth invertido

gist_gray

Gist_gray Mapa de colores - Mapa de colores en escala de grises

gist_gray_r

Mapa de colores de gist_gray invertido

gist_heat

Gist_heat mapa de colores - mapa de colores secuencial negro-rojo-amarillo-blanco

gist_heat_r

Mapa de colores de gist_heat invertido

gist_ncar

Gist_ncar mapa de colores: mapa de colores perceptualmente uniforme

gist_ncar_r

Mapa de colores de gist_ncar invertido

gist_rainbow

Gist_rainbow mapa de colores: mapa de colores perceptualmente uniforme

gist_rainbow_r

Mapa de colores de gist_rainbow invertido

gist_stern

Gist_stern mapa de colores: mapa de colores perceptualmente uniforme

gist_stern_r

Mapa de colores de gist_stern invertido

gist_yarg

Mapa de colores de Gist_yarg - Mapa de colores en escala de grises

gist_yarg_r

Mapa de colores de gist_yarg invertido

gnbu

Mapa de colores de GnBu: blanco secuencial a azul verdoso oscuro

gnbu_r

Mapa de colores de GnBu invertido

gnuplot

Mapa de colores de Gnuplot: negro a blanco secuencial con rotación de tono

gnuplot2

Mapa de colores de Gnuplot2 - negro a blanco secuencial con rotación de tono

gnuplot2_r

Mapa de colores de gnuplot2 invertido

gnuplot_r

Mapa de colores de gnuplot invertido

gray

Mapa de colores de grises - mapa de colores en escala de grises

gray_r

Mapa de colores de gris invertido

greens

Mapa de colores verdes: blanco secuencial a verde oscuro

greens_r

Mapa de colores de verdes invertidos

greys

Mapa de colores de grises: blanco secuencial a gris oscuro

greys_r

Mapa de colores de grises invertidos

hot

Mapa de colores calientes: mapa de colores secuencial negro-rojo-amarillo-blanco

hot_r

Mapa de colores calientes invertido

hsv

Mapa de colores HSV - mapa de colores de tono-saturación-valor

hsv_r

Mapa de colores HSV invertido

inferno

Mapa de colores Inferno: mapa de colores secuencial de negro a amarillo

inferno_r

Mapa de colores del infierno invertido

io-bii

IO-BII Mapa de colores - Mapa de colores del índice de biodiversidad

io-lulc

IO-LULC Mapa de colores - Mapa de colores de uso del suelo/cobertura del suelo

io-lulc-9-class

Mapa de colores de IO-LULC 9 clases

jet

Mapa de colores de Jet - mapa de colores secuencial azul-verde-amarillo-rojo

jet_r

Mapa de colores de chorro invertido

jrc-change

Mapa de colores de cambio de JRC

jrc-extent

Mapa de colores de la extensión JRC

jrc-occurrence

Mapa de colores de ocurrencias del JRC

jrc-recurrence

Mapa de colores de recurrencia del JRC

jrc-seasonality

Mapa de colores de estacionalidad del JRC

jrc-transitions

Mapa de colores de las transiciones del JRC

lidar-classification

Mapa de colores de la clasificación LiDAR

lidar-hag

Mapa de colores de la altura del Lidar sobre el suelo

lidar-hag-alternative

Mapa de colores alternativo de altura LIDAR sobre el suelo

lidar-intensity

Mapa de colores de intensidad LiDAR

lidar-returns

Lidar devuelve el mapa de colores

magma

Mapa de colores de magma: mapa de colores secuencial de negro a amarillo

magma_r

Mapa de colores de magma invertido

modis-10A1

Mapa de colores de MODIS 10A1

modis-10A2

Mapa de colores de MODIS 10A2

modis-13A1|Q1

MODIS 13A1|Mapa de colores Q1

modis-14A1|A2

MODIS 14A1|Mapa de colores A2

modis-15A2H|A3H

MODIS 15A2H|Mapa de colores A3H

modis-16A3GF-ET

Mapa de colores de MODIS 16A3GF-ET

modis-16A3GF-PET

Mapa de colores de MODIS 16A3GF-PET

modis-17A2H|A2HGF

MODIS 17A2H|Mapa de colores de A2HGF

modis-17A3HGF

Mapa de colores de MODIS 17A3HGF

modis-64A1

Mapa de colores de MODIS 64A1

mtbs-severity

Mapa de colores de la gravedad de MTBS

nipy_spectral

Nipy_spectral mapa de colores: mapa de colores perceptualmente uniforme

nipy_spectral_r

Mapa de colores de nipy_spectral invertido

nrcan-lulc

Mapa de colores de uso del suelo/cobertura del suelo de NRCAN

ocean

Mapa de colores oceánico: mapa de colores secuencial de azul a blanco

ocean_r

Mapa de colores del océano invertido

oranges

Mapa de colores de naranjas: blanco secuencial a naranja oscuro

oranges_r

Mapa de colores de naranjas invertidas

orrd

Mapa de colores de OrRd: de blanco secuencial a rojo anaranjado oscuro

orrd_r

Mapa de colores de OrRd invertido

paired

Mapa de colores emparejado: mapa de colores cualitativo con colores distintos

paired_r

Mapa de colores emparejado invertido

pastel1

Pastel1 colormap - mapa de colores cualitativo con colores pastel

pastel1_r

Mapa de colores pastel invertido1

pastel2

Mapa de colores Pastel2 - mapa de colores cualitativo con colores pastel

pastel2_r

Mapa de colores pastel2 invertido

pink

Mapa de colores rosa: blanco secuencial a rosa oscuro

pink_r

Mapa de colores rosa invertido

piyg

Mapa de colores de PiYG: rosa a verde divergente

piyg_r

Mapa de colores PiYG invertido

plasma

Mapa de colores de plasma: mapa de colores secuencial de negro a amarillo

plasma_r

Mapa de colores de plasma invertido

prgn

Mapa de colores PRGn: púrpura a verde divergente

prgn_r

Mapa de colores PRGn invertido

prism

Mapa de colores del prisma: mapa de colores cualitativo con colores distintos

prism_r

Mapa de colores del prisma invertido

pubu

Mapa de colores de PuBu: de blanco secuencial a azul oscuro

pubu_r

Mapa de colores de PuBu invertido

pubugn

Mapa de colores de PuBuGn: blanco secuencial a azul verdoso oscuro

pubugn_r

Mapa de colores de PuBuGn invertido

puor

Mapa de colores PuOr - púrpura divergente a naranja

puor_r

Mapa de colores PuOr invertido

purd

Mapa de colores de PuRd: de blanco secuencial a rojo púrpura oscuro

purd_r

Mapa de colores PuRd invertido

purples

Mapa de colores púrpuras: secuencial de blanco a morado oscuro

purples_r

Mapa de colores de morados invertidos

qpe

Mapa de colores QPE: mapa de colores cualitativo con colores distintos

rainbow

Mapa de colores del arco iris: mapa de colores cualitativo con colores distintos

rainbow_r

Mapa de colores del arco iris invertido

rdbu

Mapa de colores de RdBu: rojo a azul divergente

rdbu_r

Mapa de colores de RdBu invertido

rdgy

Mapa de colores de RdGy: rojo a gris divergente

rdgy_r

Mapa de colores de RdGy invertido

rdpu

Mapa de colores de RdPu: blanco secuencial a rojo púrpura oscuro

rdpu_r

Mapa de colores de RdPu invertido

rdylbu

Mapa de colores de RdYlBu: rojo divergente a amarillo a azul

rdylbu_r

Mapa de colores de RdYlBu invertido

rdylgn

Mapa de colores de RdYlGn: rojo divergente a amarillo a verde

rdylgn_r

Mapa de colores de RdYlGn invertido

reds

Mapa de colores de rojos: blanco secuencial a rojo oscuro

reds_r

Mapa de colores de rojos invertidos

rplumbo

Mapa de colores de Rplumbo: mapa de colores cualitativo con colores distintos

schwarzwald

Mapa de colores de Schwarzwald - mapa de colores cualitativo con colores distintos

seismic

Mapa de colores sísmico: azul a rojo divergente

seismic_r

Mapa de colores sísmico inverso

set1

Set1 colormap - mapa de colores cualitativo con colores distintos

set1_r

Mapa de colores del conjunto invertido1

set2

Set2 colormap - mapa de colores cualitativo con colores distintos

set2_r

Mapa de colores set2 invertido

set3

Set3 colormap - mapa de colores cualitativo con colores distintos

set3_r

Mapa de colores set3 invertido

spectral

Mapa de colores espectral: rojo divergente a amarillo a azul

spectral_r

Mapa de colores espectral invertido

spring

Mapa de colores de primavera: magenta a amarillo secuencial

spring_r

Mapa de colores de primavera invertida

summer

Mapa de colores de verano: verde a amarillo secuencial

summer_r

Mapa de colores de verano invertido

tab10

Mapa de colores Tab10 - mapa de colores cualitativo con colores distintos

tab10_r

Mapa de colores de la pestaña 10 invertida

tab20

Mapa de colores Tab20 - mapa de colores cualitativo con colores distintos

tab20_r

Mapa de colores tab20 invertido

tab20b

Mapa de colores Tab20b - mapa de colores cualitativo con colores distintos

tab20b_r

Mapa de colores tab20b invertido

tab20c

Mapa de colores Tab20c - mapa de colores cualitativo con colores distintos

tab20c_r

Mapa de colores de la pestaña invertida20c

terrain

Mapa de colores del terreno: secuencial de negro a blanco con rotación de tono

terrain_r

Mapa de colores del terreno invertido

twilight

Mapa de colores del crepúsculo: azul a rojo divergente

twilight_r

Mapa de colores del crepúsculo invertido

twilight_shifted

Mapa de colores desplazado del crepúsculo: azul a rojo divergente

twilight_shifted_r

Mapa de colores desplazado del crepúsculo invertido

usda-cdl

Mapa de colores de la CDL del USDA - clasificación de la cobertura del suelo

usda-cdl-corn

Mapa de colores del maíz CDL del USDA

usda-cdl-cotton

Mapa de colores del algodón CDL del USDA

usda-cdl-soybeans

Mapa de colores de la soja CDL del USDA

usda-cdl-wheat

Mapa de colores del trigo CDL del USDA

usgs-lcmap

Mapa de colores LCMAP del USGS

viirs-10a1

Mapa de colores de VIIRS 10A1

viirs-13a1

Mapa de colores de VIIRS 13A1

viirs-14a1

Mapa de colores de VIIRS 14A1

viirs-15a2H

Mapa de colores de VIIRS 15A2H

viridis

Mapa de colores de Viridis - mapa de colores secuencial de negro a amarillo

viridis_r

Mapa de colores de viridis invertido

winter

Mapa de colores de invierno: azul a verde secuencial

winter_r

Mapa de colores de invierno invertido

wistia

Mapa de colores de Wistia: blanco a amarillo secuencial

wistia_r

Mapa de colores de wistia invertido

ylgn

Mapa de colores de YlGn: de blanco secuencial a verde oscuro

ylgn_r

Mapa de colores de YlGn invertido

ylgnbu

Mapa de colores de YlGnBu: blanco secuencial a azul verdoso oscuro

ylgnbu_r

Mapa de colores de YlGnBu invertido

ylorbr

Mapa de colores de YlOrBr: de blanco secuencial a marrón anaranjado oscuro

ylorbr_r

Mapa de colores de YlOrBr invertido

ylorrd

Mapa de colores de YlOrRd: de blanco secuencial a rojo anaranjado oscuro

ylorrd_r

Mapa de colores de YlOrRd invertido

Resampling

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