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 |
---|---|---|---|---|
collection
|
path | True |
string maxLength: 500pattern: .* |
Identificador de colección STAC |
format
|
path | True |
string maxLength: 500pattern: .* |
Formato de salida para el mosaico o la imagen (por ejemplo, png, jpeg, webp) (predeterminado: "png"). |
item
|
path | True |
string maxLength: 500pattern: .* |
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 |
Nombre del algoritmo |
||
algorithm_params
|
query |
string |
Parámetro del algoritmo |
|
asset_as_band
|
query |
boolean |
Activo como banda |
|
asset
|
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 |
Nombre del mapa de colores |
||
coord-crs
|
query |
string |
Sistema de referencia de coordenadas de las coordenadas de entrada. El valor predeterminado es |
|
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 |
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 |
Geo |
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 |
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. |
Objeto de error. |
Azure. |
Respuesta que contiene los detalles del error. |
Azure. |
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. |
Color |
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 |
Matriz de detalles sobre errores específicos que llevaron a este error notificado. |
|
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 |
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 |
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 |