Partilhar via


Mosaics Tile Matrix Sets - Get Zxy Scalex Format

Tile Tilematrixsetid como caminho
Crie um mosaico de mapa.

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/mosaic/{searchId}/tiles/{tileMatrixSetId}/{z}/{x}/{y}@{scale}x.{format}?api-version=2025-04-30-preview
GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/mosaic/{searchId}/tiles/{tileMatrixSetId}/{z}/{x}/{y}@{scale}x.{format}?api-version=2025-04-30-preview&assets={assets}&expression={expression}&assetBidx={assetBidx}&asset_as_band={asset_as_band}&nodata={nodata}&unscale={unscale}&scan_limit={scan_limit}&items_limit={items_limit}&time_limit={time_limit}&exitwhenfull={exitwhenfull}&skipcovered={skipcovered}&algorithm={algorithm}&algorithm_params={algorithm_params}&buffer={buffer}&color_formula={color_formula}&collection={collection}&resampling={resampling}&pixel_selection={pixel_selection}&rescale={rescale}&colormap_name={colormap_name}&colormap={colormap}&return_mask={return_mask}

Parâmetros do URI

Name Em Necessário Tipo Description
format
path True

string

maxLength: 500
pattern: .*

Formato de saída para o bloco ou imagem (por exemplo, png, jpeg, webp) (padrão: "png").

scale
path True

number (float)

Fator de escala numérica para o bloco. Valores mais altos produzem blocos maiores (padrão: "1")

searchId
path True

string

maxLength: 500
pattern: .*

ID de pesquisa (hash de pesquisa pgSTAC)

tileMatrixSetId
path True

string

maxLength: 500
pattern: .*

Identificador selecionando um dos TileMatrixSetId suportados

x
path True

number (float)

Índice de coluna (X) do bloco na TileMatrix selecionada. Ele não pode exceder o MatrixHeight-1 para o TileMatrix selecionado.

y
path True

number (float)

Índice de linha (Y) do bloco na TileMatrix selecionada. Ele não pode exceder o MatrixWidth-1 para o TileMatrix selecionado.

z
path True

number (float)

Identifier (Z) selecionando uma das escalas definidas no TileMatrixSet e representando o scaleDenominator do bloco.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

algorithm
query

Algorithm

Nome do algoritmo

algorithm_params
query

string

Parâmetro do algoritmo

asset_as_band
query

boolean

Ativo como Banda

assetBidx
query

string[]

Índices por banda de ativos (índices separados por coma)

assets
query

string[]

Nomes dos ativos.

buffer
query

string

Buffer em cada lado da telha fornecida. Deve ser um múltiplo de 0.5. O tamanho do bloco de saída será expandido para tilesize + 2 * buffer (por exemplo, 0,5 = 257x257, 1,0 = 258x258).

collection
query

string

ID da coleção STAC

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

ColorMapNames

Nome do mapa de cores

exitwhenfull
query

boolean

Retorne assim que a geometria estiver totalmente coberta (o padrão é True no PgSTAC).

expression
query

string

Expressão matemática de banda entre ativos

items_limit
query

integer (int32)

Retorne assim que tivermos N itens por geometria (o padrão é 100 no PgSTAC).

nodata
query

number (float)

Substituir valor Nodata interno

pixel_selection
query

PixelSelection

Método de seleção de pixels.

resampling
query

Resampling

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.

scan_limit
query

integer (int32)

Retorne assim que verificarmos N itens (o padrão é 10000 em PgSTAC).

skipcovered
query

boolean

Ignore todos os itens que apareceriam completamente sob os itens anteriores (o padrão é True no PgSTAC).

time_limit
query

integer (int32)

Retorne após N segundos para evitar solicitações longas (o padrão é 5 em PgSTAC).

unscale
query

boolean

Aplicar escala ou deslocamento interno

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"

204 No Content

Não há conteúdo para enviar para esta solicitação, mas os cabeçalhos podem ser úteis.

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

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

MosaicsTileMatrixSets_GetZxyScalexFormat

Pedido de amostra

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/mosaic/search-0df36a74d7ed/tiles/WebMercatorQuad/0/0/0@1x.png?api-version=2025-04-30-preview

Resposta da amostra

"PNG raw file bytes"

Definições

Name Description
Algorithm

Algoritmos suportados para análise baseada em terreno e índice

Azure.Core.Foundations.Error

O objeto de erro.

Azure.Core.Foundations.ErrorResponse

Uma resposta contendo detalhes do 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.

ColorMapNames

Mapas coloridos disponíveis para visualização de dados

PixelSelection

Identificador selecionando um dos TileMatrixSetId suportados (padrão: 'WebMercatorQuad')Identificador selecionando um dos TileMatrixSetId suportados (padrão: 'WebMercatorQuad')Método usado para selecionar ou calcular pixels ao criar compósitos de várias fontes

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

Azure.Core.Foundations.Error[]

Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.

innererror

Azure.Core.Foundations.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

Azure.Core.Foundations.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

Azure.Core.Foundations.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

PixelSelection

Identificador selecionando um dos TileMatrixSetId suportados (padrão: 'WebMercatorQuad')Identificador selecionando um dos TileMatrixSetId suportados (padrão: 'WebMercatorQuad')Método usado para selecionar ou calcular pixels ao criar compósitos de várias fontes

Valor Description
first

Selecionar pixel na primeira imagem disponível

highest

Selecionar pixel com o valor mais alto

lastbandhight

Selecionar imagem com maior valor na última banda

lastbandlow

Selecionar imagem com menor valor na última banda

lowest

Selecionar pixel com o menor valor

mean

Calcular a média dos pixels disponíveis

median

Calcular a mediana dos pixels disponíveis

stdev

Calcular o desvio padrão dos pixels disponíveis

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