Tiler Geo Jsons - Crop Widthx Height Format
Geojson Colheita
Crie uma imagem a partir de um recurso geojson.
POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/crop/{width}x{height}.{format}?api-version=2025-04-30-preview
POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/crop/{width}x{height}.{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}&rescale={rescale}&colormap_name={colormap_name}&colormap={colormap}&return_mask={return_mask}
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
collection
|
path | True |
string maxLength: 500pattern: .* |
Identificador da coleção STAC |
format
|
path | True |
string maxLength: 500pattern: .* |
Formato de saída para o bloco ou imagem (por exemplo, png, jpeg, webp). |
height
|
path | True |
number (float) |
Altura em pixels para a imagem de saída. |
item
|
path | True |
string maxLength: 500pattern: .* |
Identificador de item STAC |
width
|
path | True |
number (float) |
Largura em pixels para a imagem de saída. |
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
algorithm
|
query |
Nome do algoritmo |
||
algorithm_params
|
query |
string |
Parâmetro do algoritmo |
|
asset_as_band
|
query |
boolean |
Ativo como Banda |
|
asset
|
query |
string[] |
Índices por banda de ativos (índices separados por coma) |
|
assets
|
query |
string[] |
Nomes dos ativos. |
|
color_formula
|
query |
string |
rio-color formula (info: https://github.com/mapbox/rio-color) |
|
colormap
|
query |
string |
Mapa de cores personalizado codificado por JSON |
|
colormap_name
|
query |
Nome do mapa de cores |
||
coord-crs
|
query |
string |
Sistema de Referência de Coordenadas dos coords de entrada. Padrão para |
|
expression
|
query |
string |
Expressão matemática de banda entre ativos |
|
max_size
|
query |
integer (int32) |
Limite de tamanho de saída de imagem se os limites de largura e altura não estiverem definidos. |
|
nodata
|
query |
number (float) |
Substituir valor Nodata interno |
|
resampling
|
query |
Método de nova amostragem. |
||
rescale
|
query |
string[] |
vírgula (',') delimitada Min,Max intervalo. Pode definir várias vezes para várias bandas. |
|
return_mask
|
query |
boolean |
Adicione máscara aos dados de saída. |
|
unscale
|
query |
boolean |
Aplicar escala ou deslocamento interno |
Corpo do Pedido
Name | Tipo | Description |
---|---|---|
body |
Geo |
Solicitar corpo GeoJson. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
file |
Retornar uma imagem. Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json" |
Other Status Codes |
Uma resposta de erro inesperada. Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json" Cabeçalhos x-ms-error-code: string |
Segurança
OAuth2Auth
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
https://geocatalog.spatio.azure.com/.default |
Exemplos
TilerGeoJsons_CropWidthxHeightFormat
Pedido de amostra
POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/collectionId-0df36a74d7ed/items/item-0df36a74d7ed/crop/0x0.png?api-version=2025-04-30-preview
{
"type": "Feature",
"stac_version": "1.0.0",
"stac_extensions": [
"https://stac-extensions.github.io/projection/v1.0.0/schema.json"
],
"id": "test-item-0df36a74d7ed",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-65.75386020444417,
18.252659831448764
],
[
-65.75385878091376,
18.252569552371305
],
[
-65.75376429311993,
18.252570912467043
],
[
-65.75376571660163,
18.252661191551685
],
[
-65.75386020444417,
18.252659831448764
]
]
]
},
"bbox": [
-65.75386020444417,
18.252569552371305,
-65.75376429311993,
18.252661191551685
],
"properties": {
"proj:epsg": 26920,
"proj:shape": [
10,
10
],
"proj:transform": [
208796.4,
1,
0,
2020332.3,
0,
-1
],
"proj:bbox": [
208796.4,
2020322.3,
208806.4,
2020332.3
],
"datetime": "2024-11-06T22:49:19.098983Z"
},
"links": [
{
"rel": "self",
"href": "https://spatiocitest.blob.core.windows.net/test-data-0df36a74d7ed/test-item.json",
"type": "application/json"
}
],
"assets": {
"data": {
"href": "https://spatiocitest.blob.core.windows.net/test-data-0df36a74d7ed/asset.tif",
"type": "image/tiff; application=geotiff",
"title": "Test data",
"roles": [
"data"
]
}
},
"collection": "test-collection-0df36a74d7ed"
}
Resposta da amostra
"PNG raw file bytes"
Definições
Name | Description |
---|---|
Algorithm |
Algoritmos suportados para análise baseada em terreno e índice |
Azure. |
O objeto de erro. |
Azure. |
Uma resposta contendo detalhes do erro. |
Azure. |
Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. |
Color |
Mapas coloridos disponíveis para visualização de dados |
Resampling |
Algoritmo de reamostragem para usar ao ler dados raster de origem em resoluções diferentes |
Algorithm
Algoritmos suportados para análise baseada em terreno e índice
Valor | Description |
---|---|
contours |
Gera linhas de contorno de elevação |
hillshade |
Cria visualização de hillshade a partir de dados de elevação |
normalizedIndex |
Calcula o índice de diferença normalizado entre bandas |
terrainrgb |
Codifica dados de elevação no formato Mapbox TerrainRGB |
terrarium |
Codifica dados de elevação no formato Mapbox Terrarium RGB |
Azure.Core.Foundations.Error
O objeto de erro.
Name | Tipo | Description |
---|---|---|
code |
string |
Um de um conjunto de códigos de erro definido pelo servidor. |
details |
Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado. |
|
innererror |
Um objeto que contém informações mais específicas do que o objeto atual sobre o erro. |
|
message |
string |
Uma representação legível por humanos do erro. |
target |
string |
O alvo do erro. |
Azure.Core.Foundations.ErrorResponse
Uma resposta contendo detalhes do erro.
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
Azure.Core.Foundations.InnerError
Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
Name | Tipo | Description |
---|---|---|
code |
string |
Um de um conjunto de códigos de erro definido pelo servidor. |
innererror |
Erro interno. |
ColorMapNames
Mapas coloridos disponíveis para visualização de dados
Valor | Description |
---|---|
accent |
Accent colormap - mapa de cores qualitativo com cores distintas |
accent_r |
Mapa de cores de destaque invertido |
afmhot |
Afmhot colormap - mapa de cores sequencial preto-vermelho-amarelo-branco |
afmhot_r |
Mapa de cores afmhot invertido |
ai4g-lulc |
AI para o bom uso da terra / mapa de cores de cobertura da terra |
alos-fnf |
Mapa colorado da floresta/não-floresta ALOS |
alos-palsar-mask |
Mapa colorado da máscara ALOS PALSAR |
autumn |
Mapa de cores de outono - mapa de cores sequencial vermelho-laranja-amarelo |
autumn_r |
Mapa colorido de outono invertido |
binary |
Mapa de cores binário - mapa de cores preto e branco simples |
binary_r |
Mapa de cores binário invertido |
blues |
Mapa de cores azuis - branco sequencial a azul escuro |
blues_r |
Mapa de cores azuis invertido |
bone |
Mapa de cores ósseas - escala de cinza com tonalidade azul ligeira |
bone_r |
Mapa de cores ósseas invertido |
brbg |
BrBG colormap - divergente marrom para azul-esverdeado |
brbg_r |
Mapa de cores BrBG invertido |
brg |
BrG colormap - marrom divergente para verde |
brg_r |
Mapa de cores BrG invertido |
bugn |
BuGn colormap - branco sequencial a verde escuro |
bugn_r |
Mapa de cores BuGn invertido |
bupu |
BuPu colormap - branco sequencial a roxo escuro |
bupu_r |
Mapa colorido de BuPu invertido |
bwr |
BWR colormap - azul divergente para vermelho |
bwr_r |
Mapa de cores BWR invertido |
c-cap |
Mapa colorido C-CAP - classificação da cobertura do solo |
cfastie |
Cfastie colormap - mapa de cores de alto contraste |
chesapeake-lc-13 |
Mapa colorado de 13 classes da cobertura terrestre de Chesapeake |
chesapeake-lc-7 |
Mapa colorido de 7 classes da cobertura terrestre de Chesapeake |
chesapeake-lu |
Mapa colorido do uso da terra de Chesapeake |
chloris-biomass |
Mapa colorado da biomassa de Chloris |
cividis |
Cividis colormap - amarelo sequencial a azul |
cividis_r |
Mapa de cores cividis invertido |
cmrmap |
CMRmap colormap - mapa de cores percetivamente uniforme |
cmrmap_r |
Mapa de cores CMRmap invertido |
cool |
Cool colormap - ciano sequencial para magenta |
cool_r |
Mapa de cores fresco invertido |
coolwarm |
Mapa de cores Coolwarm - azul divergente para vermelho |
coolwarm_r |
Mapa de cores coolwarm invertido |
copper |
Mapa de cores de cobre - preto sequencial para cobre |
copper_r |
Mapa de cores de cobre invertido |
cubehelix |
Cubehelix colormap - sequencial preto a branco com rotação de matiz |
cubehelix_r |
Mapa de cores de cubeélice invertida |
dark2 |
Dark2 colormap - mapa de cores qualitativo com cores distintas |
dark2_r |
Mapa de cores escuro2 invertido |
drcog-lulc |
Mapa colorido do uso da terra/cobertura da terra DRCog |
esa-cci-lc |
Mapa colorido da cobertura da terra CCI da ESA |
esa-worldcover |
Mapa colorido do ESA WorldCover |
flag |
Sinalizar colormap - mapa de cores qualitativo com cores distintas |
flag_r |
Mapa colorido da bandeira invertida |
gap-lulc |
Mapa colorido de uso da terra/cobertura da terra GAP |
gist_earth |
Gist_earth colormap - mapa de cores percetivamente uniforme |
gist_earth_r |
Mapa de cores gist_earth invertido |
gist_gray |
Gist_gray colormap - mapa de cores em escala de cinza |
gist_gray_r |
Mapa colorido gist_gray invertido |
gist_heat |
Gist_heat colormap - mapa de cores sequencial preto-vermelho-amarelo-branco |
gist_heat_r |
Mapa de cores gist_heat invertido |
gist_ncar |
Gist_ncar colormap - mapa de cores percetivamente uniforme |
gist_ncar_r |
Mapa de cores gist_ncar invertido |
gist_rainbow |
Gist_rainbow colormap - mapa de cores percetivamente uniforme |
gist_rainbow_r |
Mapa colorido gist_rainbow invertido |
gist_stern |
Gist_stern ColorMap - Mapa de cores percetivamente uniforme |
gist_stern_r |
Mapa colorido gist_stern invertido |
gist_yarg |
Gist_yarg colormap - mapa de cores em escala de cinza |
gist_yarg_r |
Mapa de cores gist_yarg invertido |
gnbu |
GnBu colormap - branco sequencial a azul-esverdeado escuro |
gnbu_r |
Mapa de cores GnBu invertido |
gnuplot |
Mapa de cores Gnuplot - sequencial preto a branco com rotação de tonalidade |
gnuplot2 |
Gnuplot2 colormap - sequencial preto a branco com rotação de tonalidade |
gnuplot2_r |
Mapa de cores do gnuplot2 invertido |
gnuplot_r |
Mapa de cores do gnuplot invertido |
gray |
Mapa de cores cinza - mapa de cores em escala de cinza |
gray_r |
Mapa de cores cinza invertido |
greens |
Mapa de cores dos verdes - branco sequencial a verde escuro |
greens_r |
Mapa de cores verdes invertido |
greys |
Mapa de cores cinza - branco sequencial a cinza escuro |
greys_r |
Mapa de cores cinza invertido |
hot |
Hot colormap - mapa de cores sequencial preto-vermelho-amarelo-branco |
hot_r |
Mapa de cores quente invertido |
hsv |
Mapa de cores HSV - mapa de cores de valor de saturação de matiz |
hsv_r |
Mapa de cores HSV invertido |
inferno |
Inferno colormap - mapa de cores sequencial preto a amarelo |
inferno_r |
Mapa de cores do inferno invertido |
io-bii |
IO-BII colormap - índice de biodiversidade colormap |
io-lulc |
IO-LULC colormap - mapa colorário de uso da terra/cobertura da terra |
io-lulc-9-class |
IO-LULC Mapa de cores de 9 classes |
jet |
Jet colormap - mapa de cores sequencial azul-verde-amarelo-vermelho |
jet_r |
Mapa de cores do jato invertido |
jrc-change |
JRC alterar mapa de cores |
jrc-extent |
Mapa colorado da extensão do CCI |
jrc-occurrence |
Mapa colorido da ocorrência do CCI |
jrc-recurrence |
Mapa colorado de recorrência do CCI |
jrc-seasonality |
Mapa coloral da sazonalidade do CCI |
jrc-transitions |
Mapa de cores das transições do JRC |
lidar-classification |
Mapa de cores da classificação lidar |
lidar-hag |
Mapa colorado da altura do lidar acima do solo |
lidar-hag-alternative |
Mapa de cores alternativo da altura do lidar acima do solo |
lidar-intensity |
Mapa colorado da intensidade do lidar |
lidar-returns |
O Lidar devolve o mapa de cores |
magma |
Magma colormap - mapa de cores sequencial preto a amarelo |
magma_r |
Mapa de cores de magma invertido |
modis-10A1 |
Mapa de cores MODIS 10A1 |
modis-10A2 |
Mapa de cores MODIS 10A2 |
modis-13A1|Q1 |
MODIS 13A1 |Mapa de cores Q1 |
modis-14A1|A2 |
MODIS 14A1 |Mapa de cores A2 |
modis-15A2H|A3H |
MODIS 15A2H|Mapa de cores A3H |
modis-16A3GF-ET |
Mapa de cores MODIS 16A3GF-ET |
modis-16A3GF-PET |
Mapa de cores MODIS 16A3GF-PET |
modis-17A2H|A2HGF |
MODIS 17A2H|Mapa de cores A2HGF |
modis-17A3HGF |
Mapa de cores MODIS 17A3HGF |
modis-64A1 |
Mapa de cores MODIS 64A1 |
mtbs-severity |
Mapa de cores da gravidade do MTBS |
nipy_spectral |
Nipy_spectral colormap - mapa de cores percetivamente uniforme |
nipy_spectral_r |
Mapa colorido nipy_spectral invertido |
nrcan-lulc |
Mapa colorido de uso da terra/cobertura da terra NRCAN |
ocean |
Mapa de cores do oceano - mapa de cores sequencial azul a branco |
ocean_r |
Mapa de cores do oceano invertido |
oranges |
Mapa de cores laranjas - branco sequencial a laranja escuro |
oranges_r |
Mapa de cores laranjas invertido |
orrd |
Mapa de cores OrRd - branco sequencial a vermelho-laranja escuro |
orrd_r |
Mapa de cores OrRd invertido |
paired |
Mapa de cores emparelhado - mapa de cores qualitativo com cores distintas |
paired_r |
Mapa de cores emparelhado invertido |
pastel1 |
Pastel1 colormap - mapa de cores qualitativo com cores pastel |
pastel1_r |
Mapa de cores pastel1 invertido |
pastel2 |
Pastel2 colormap - mapa de cores qualitativo com cores pastel |
pastel2_r |
Mapa de cores pastel2 invertido |
pink |
Mapa de cores rosa - branco sequencial a rosa escuro |
pink_r |
Mapa de cores rosa invertido |
piyg |
PiYG colormap - divergir rosa para verde |
piyg_r |
Mapa de cores PiYG invertido |
plasma |
Mapa de cores de plasma - mapa de cores sequencial preto a amarelo |
plasma_r |
Mapa de cores de plasma invertido |
prgn |
PRGn colormap - divergindo roxo para verde |
prgn_r |
Mapa de cores PRGn invertido |
prism |
Prism colormap - mapa de cores qualitativo com cores distintas |
prism_r |
Mapa colorido de prisma invertido |
pubu |
PuBu colormap - branco sequencial a azul escuro |
pubu_r |
Mapa de cores PuBu invertido |
pubugn |
PuBuGn colormap - branco sequencial a azul-esverdeado escuro |
pubugn_r |
Mapa de cores PuBuGn invertido |
puor |
Mapa de cores PuOr - divergindo roxo a laranja |
puor_r |
Mapa de cores PuOr invertido |
purd |
Mapa de cores PuRd - branco sequencial a roxo-vermelho escuro |
purd_r |
Mapa de cores PuRd invertido |
purples |
Mapa de cores roxas - branco sequencial a roxo escuro |
purples_r |
Mapa de cores roxos invertidos |
qpe |
QPE colormap - mapa de cores qualitativo com cores distintas |
rainbow |
Rainbow colormap - mapa de cores qualitativo com cores distintas |
rainbow_r |
Mapa de cores do arco-íris invertido |
rdbu |
RdBu colormap - vermelho divergente para azul |
rdbu_r |
Mapa de cores RdBu invertido |
rdgy |
Mapa de cores RdGy - vermelho divergente para cinza |
rdgy_r |
Mapa de cores RdGy invertido |
rdpu |
Mapa de cores RdPu - branco sequencial a vermelho-roxo escuro |
rdpu_r |
Mapa de cores RdPu invertido |
rdylbu |
RdYlBu colormap - divergindo vermelho para amarelo para azul |
rdylbu_r |
Mapa de cores RdYlBu invertido |
rdylgn |
RdYlGn colormap - divergindo vermelho para amarelo para verde |
rdylgn_r |
Mapa de cores RdYlGn invertido |
reds |
Mapa de cores vermelho - branco sequencial a vermelho escuro |
reds_r |
Mapa de cores vermelhos invertidos |
rplumbo |
Rplumbo colormap - mapa de cores qualitativo com cores distintas |
schwarzwald |
Schwarzwald colormap - mapa de cores qualitativo com cores distintas |
seismic |
Mapa de cores sísmico - azul divergente para vermelho |
seismic_r |
Mapa colorido sísmico reverso |
set1 |
Set1 colormap - mapa de cores qualitativo com cores distintas |
set1_r |
Mapa de cores do conjunto invertido1 |
set2 |
Set2 colormap - mapa de cores qualitativo com cores distintas |
set2_r |
Mapa de cores set2 invertido |
set3 |
Set3 colormap - mapa de cores qualitativo com cores distintas |
set3_r |
Mapa de cores do conjunto invertido3 |
spectral |
Mapa de cores espectral - divergindo vermelho para amarelo para azul |
spectral_r |
Mapa de cores espectral invertido |
spring |
Mapa colorido da primavera - magenta sequencial a amarelo |
spring_r |
Mapa de cores de primavera invertido |
summer |
Mapa de cores de verão - verde sequencial a amarelo |
summer_r |
Mapa colorido de verão invertido |
tab10 |
Tab10 colormap - mapa de cores qualitativo com cores distintas |
tab10_r |
Mapa de cores tab10 invertido |
tab20 |
Tab20 colormap - mapa de cores qualitativo com cores distintas |
tab20_r |
Mapa de cores tab20 invertido |
tab20b |
Tab20b colormap - mapa de cores qualitativo com cores distintas |
tab20b_r |
Mapa de cores tab20b invertido |
tab20c |
Tab20c colormap - mapa de cores qualitativo com cores distintas |
tab20c_r |
Mapa de cores tab20c invertido |
terrain |
Mapa de cores do terreno - sequencial preto a branco com rotação de tonalidade |
terrain_r |
Mapa colorido do terreno invertido |
twilight |
Twilight colormap - azul divergente para vermelho |
twilight_r |
Mapa de cores crepuscular invertido |
twilight_shifted |
Mapa de cores deslocado do crepúsculo - azul divergente para vermelho |
twilight_shifted_r |
Mapa de cores deslocado do crepúsculo invertido |
usda-cdl |
Mapa colormap CDL do USDA - classificação da cobertura da terra |
usda-cdl-corn |
Mapa colorado de milho CDL do USDA |
usda-cdl-cotton |
Mapa colorado de algodão CDL do USDA |
usda-cdl-soybeans |
Mapa colorado da soja CDL do USDA |
usda-cdl-wheat |
Mapa colorado do trigo CDL do USDA |
usgs-lcmap |
Mapa colormap LCMAP do USGS |
viirs-10a1 |
Mapa de cores VIIRS 10A1 |
viirs-13a1 |
Mapa de cores VIIRS 13A1 |
viirs-14a1 |
Mapa de cores VIIRS 14A1 |
viirs-15a2H |
Mapa de cores VIIRS 15A2H |
viridis |
Viridis colormap - mapa de cores sequencial preto a amarelo |
viridis_r |
Mapa de cores viridis invertido |
winter |
Mapa de cores de inverno - azul sequencial a verde |
winter_r |
Mapa de cores de inverno invertido |
wistia |
Wistia colormap - sequencial branco a amarelo |
wistia_r |
Mapa de cores wistia invertido |
ylgn |
YlGn colormap - branco sequencial a verde escuro |
ylgn_r |
Mapa de cores YlGn invertido |
ylgnbu |
Mapa de cores YlGnBu - branco sequencial a azul-esverdeado escuro |
ylgnbu_r |
Mapa de cores YlGnBu invertido |
ylorbr |
Mapa de cores YlOrBr - branco sequencial a laranja-marrom escuro |
ylorbr_r |
Mapa de cores YlOrBr invertido |
ylorrd |
Mapa de cores YlOrRd - branco sequencial a vermelho-laranja escuro |
ylorrd_r |
Mapa de cores YlOrRd invertido |
Resampling
Algoritmo de reamostragem para usar ao ler dados raster de origem em resoluções diferentes
Valor | Description |
---|---|
average |
Reamostragem média - calcula a média de todos os pixels que contribuem |
bilinear |
Interpolação bilinear - calcula os valores de saída usando uma média ponderada de células de entrada 2x2 |
cubic |
Interpolação cúbica - usa uma média ponderada de células de entrada 4x4 para resultados mais suaves |
cubic_spline |
Interpolação cúbica de spline - semelhante ao cúbico, mas preserva melhor as bordas |
gauss |
Reamostragem ponderada gaussiana - aplica uma ponderação gaussiana aos pixels contribuintes |
lanczos |
Reamostragem de sinc com janelas Lanczos - alta qualidade com artefatos mínimos |
mode |
Reamostragem do modo - seleciona o valor mais comum dos pixels que contribuem |
nearest |
Vizinho mais próximo - método mais rápido que seleciona o valor de pixel mais próximo |
rms |
Reamostragem quadrada média da raiz - útil para reamostragem de grelhas de erro ou desvio |