你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Tiler Tile Matrix Sets - Get Zxy Scalex Format

瓦片 tilematrixsetid As Path
从数据集创建地图瓦片。

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/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/collections/{collectionId}/items/{itemId}/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}&algorithm={algorithm}&algorithm_params={algorithm_params}&buffer={buffer}&color_formula={color_formula}&resampling={resampling}&rescale={rescale}&colormap_name={colormap_name}&colormap={colormap}&return_mask={return_mask}&subdataset_name={subdataset_name}&subdataset_bands={subdataset_bands}

URI 参数

名称 必需 类型 说明
collectionId
path True

string

maxLength: 500
pattern: .*

STAC 集合标识符

format
path True

string

maxLength: 500
pattern: .*

图块或图像的输出格式(例如,png、jpeg、webp)(默认值:“png”)。

itemId
path True

string

maxLength: 500
pattern: .*

STAC 项标识符

scale
path True

number (float)

磁贴的数字比例因子。 值越高,产生的图块越大(默认值:“1”)

tileMatrixSetId
path True

string

maxLength: 500
pattern: .*

标识符选择支持的 TileMatrixSetId 之一

x
path True

number (float)

所选 TileMatrix 上图块的列 (X) 索引。 它不能超过所选 TileMatrix 的 MatrixHeight-1。

y
path True

number (float)

所选 TileMatrix 上图块的行 (Y) 索引。 它不能超过所选 TileMatrix 的 MatrixWidth-1。

z
path True

number (float)

标识符 (Z):选择 TileMatrixSet 中定义的一个尺度,并表示瓦片的 scaleDenominator。

api-version
query True

string

minLength: 1

用于此作的 API 版本。

algorithm
query

Algorithm

算法名称

algorithm_params
query

string

算法参数

asset_as_band
query

boolean

资产作为带

assetBidx
query

string[]

按资产区间索引(昏迷分隔索引)

assets
query

string[]

资产的名称。

buffer
query

string

Buffer 在给定图块的每一侧。 它必须是 的 0.5倍数。 输出 切片大小 将扩展为 tilesize + 2 * buffer (例如 0.5 = 257x257,1.0 = 258x258)。

color_formula
query

string

rio-color 公式 (信息: https://github.com/mapbox/rio-color

colormap
query

string

JSON 编码的自定义颜色图

colormap_name
query

ColorMapNames

颜色图名称

expression
query

string

资产之间的波段数学表达式

nodata
query

number (float)

覆盖内部 Nodata 值

resampling
query

Resampling

重新采样方法。

rescale
query

string[]

逗号 (',') 分隔 Min,Max 范围。 可以为多个波段设置多个时间。

return_mask
query

boolean

将掩码添加到输出数据。

subdataset_bands
query

string[]

资产中子数据集带区的索引。

subdataset_name
query

string

资产中子数据集的名称。

unscale
query

boolean

应用内部缩放或偏移

响应

名称 类型 说明
200 OK

file

返回图像。

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

意外的错误响应。

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

标头

x-ms-error-code: string

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
https://geocatalog.spatio.azure.com/.default

示例

TilerTileMatrixSets_GetZxyScalexFormat

示例请求

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

示例响应

"PNG raw file bytes"

定义

名称 说明
Algorithm

基于 terrain 和索引的分析支持的算法

Azure.Core.Foundations.Error

错误对象。

Azure.Core.Foundations.ErrorResponse

包含错误详细信息的响应。

Azure.Core.Foundations.InnerError

包含有关错误的更具体信息的对象。 根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors

ColorMapNames

用于数据可视化的可用彩色图

Resampling

以不同分辨率读取源栅格数据时使用的重采样算法

Algorithm

基于 terrain 和索引的分析支持的算法

说明
contours

生成高程等值线

hillshade

根据高程数据创建山体阴影可视化

normalizedIndex

计算波段之间的标准化差值指数

terrainrgb

以 Mapbox TerrainRGB 格式对高程数据进行编码

terrarium

以 Mapbox Terrarium RGB 格式对高程数据进行编码

Azure.Core.Foundations.Error

错误对象。

名称 类型 说明
code

string

服务器定义的错误代码集之一。

details

Azure.Core.Foundations.Error[]

导致此报告错误的特定错误的详细信息数组。

innererror

Azure.Core.Foundations.InnerError

包含与当前对象有关错误的更具体信息的对象。

message

string

有关错误的可读的表示形式。

target

string

错误的目标。

Azure.Core.Foundations.ErrorResponse

包含错误详细信息的响应。

名称 类型 说明
error

Azure.Core.Foundations.Error

错误对象。

Azure.Core.Foundations.InnerError

包含有关错误的更具体信息的对象。 根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors

名称 类型 说明
code

string

服务器定义的错误代码集之一。

innererror

Azure.Core.Foundations.InnerError

内部错误。

ColorMapNames

用于数据可视化的可用彩色图

说明
accent

Accent colormap - 具有不同颜色的定性颜色图

accent_r

反转重音颜色图

afmhot

Afmhot colormap - 顺序黑-红-黄-白颜色图

afmhot_r

反向 afmhot 颜色图

ai4g-lulc

用于良好土地利用/土地覆被色彩图的 AI

alos-fnf

ALOS 林/非林颜色图

alos-palsar-mask

ALOS PALSAR 蒙版颜色图

autumn

秋季色彩图 - 顺序红-橙-黄色彩图

autumn_r

反转的秋季色彩图

binary

Binary colormap - 简单的黑白颜色图

binary_r

反向二进制颜色图

blues

蓝色颜色图 - 从白色到深蓝色的顺序

blues_r

反转蓝色颜色图

bone

骨骼颜色图 - 带有轻微蓝色调的灰度

bone_r

反转骨骼颜色图

brbg

BrBG 颜色图 - 从棕色到蓝绿色发散

brbg_r

反向 BrBG 颜色图

brg

BrG 颜色图 - 从棕色到绿色发散

brg_r

反向 BrG 颜色图

bugn

BuGn 颜色图 - 从白色到深绿色的顺序

bugn_r

反向 BuGn 颜色图

bupu

BuPu 颜色图 - 从白色到深紫色的顺序

bupu_r

反向 BuPu 颜色图

bwr

BWR 颜色图 - 从蓝色发散到红色

bwr_r

反向 BWR 颜色图

c-cap

C-CAP 色彩图 - 土地覆被分类

cfastie

Cfastie colormap - 高对比度颜色图

chesapeake-lc-13

切萨皮克土地覆被 13 类色彩图

chesapeake-lc-7

切萨皮克土地覆被 7 类色彩图

chesapeake-lu

切萨皮克土地利用色彩图

chloris-biomass

Chloris 生物量色图

cividis

Cividis 颜色图 - 从黄色到蓝色的顺序

cividis_r

反向 cividis 颜色图

cmrmap

CMRmap colormap colormap - 感知均匀的颜色图

cmrmap_r

反向 CMRmap 颜色图

cool

冷色颜色图 - 从青色到洋红色的顺序

cool_r

反向冷色图

coolwarm

Coolwarm 颜色图 - 从蓝色发散到红色

coolwarm_r

反向 coolwarm 颜色图

copper

铜色图 - 连续黑色到铜色

copper_r

Reversed copper colormap (反转铜色图)

cubehelix

Cubehelix 颜色图 - 具有色相旋转的连续黑色到白色

cubehelix_r

反向 cubehelix 颜色图

dark2

Dark2 colormap - 具有不同颜色的定性颜色图

dark2_r

反向 dark2 颜色图

drcog-lulc

DRCog 土地利用/土地覆被色彩图

esa-cci-lc

ESA CCI 土地覆被色彩图

esa-worldcover

ESA WorldCover 颜色图

flag

Flag colormap - 具有不同颜色的定性颜色图

flag_r

反向标志颜色图

gap-lulc

GAP 土地利用/土地覆被色彩图

gist_earth

Gist_earth colormap - 感知均匀的颜色图

gist_earth_r

反向 gist_earth 颜色图

gist_gray

Gist_gray colormap - 灰度颜色图

gist_gray_r

反向 gist_gray 颜色图

gist_heat

Gist_heat colormap - 顺序黑-红-黄-白颜色图

gist_heat_r

反向 gist_heat 颜色图

gist_ncar

Gist_ncar colormap - 感知均匀的颜色图

gist_ncar_r

反向 gist_ncar 颜色图

gist_rainbow

Gist_rainbow colormap - 感知均匀的颜色图

gist_rainbow_r

反向 gist_rainbow 颜色图

gist_stern

Gist_stern colormap - 感知均匀的颜色图

gist_stern_r

反向 gist_stern 颜色图

gist_yarg

Gist_yarg colormap - 灰度颜色图

gist_yarg_r

反向 gist_yarg 颜色图

gnbu

GnBu 颜色图 - 从白色到深蓝绿色的顺序

gnbu_r

反向 GnBu 颜色图

gnuplot

Gnuplot 颜色图 - 带色相旋转的连续黑色到白色

gnuplot2

Gnuplot2 颜色图 - 带有色相旋转的连续黑色到白色

gnuplot2_r

反转的 gnuplot2 颜色图

gnuplot_r

反向 gnuplot 颜色图

gray

Gray colormap - 灰度颜色图

gray_r

反转灰色颜色图

greens

绿色颜色图 - 从白色到深绿色的顺序

greens_r

反转绿色颜色图

greys

灰色颜色图 - 从白色到深灰色的顺序

greys_r

反转灰色颜色图

hot

热门颜色图 - 顺序黑色-红色-黄色-白色颜色图

hot_r

反转热色图

hsv

HSV 颜色图 - 色相饱和度值颜色图

hsv_r

反向 HSV 颜色图

inferno

Inferno 颜色图 - 连续的黑色到黄色颜色图

inferno_r

Reversed Inferno 颜色图

io-bii

IO-BII colormap - 生物多样性指数颜色图

io-lulc

IO-LULC 颜色图 - 土地利用/土地覆被颜色图

io-lulc-9-class

IO-LULC 9 类颜色图

jet

Jet colormap - 顺序蓝-绿-黄-红颜色图

jet_r

反向喷气颜色图

jrc-change

JRC 更改颜色图

jrc-extent

JRC 范围颜色图

jrc-occurrence

JRC 出现颜色图

jrc-recurrence

JRC 递归颜色图

jrc-seasonality

JRC 季节性颜色图

jrc-transitions

JRC 过渡颜色图

lidar-classification

激光雷达分类色彩图

lidar-hag

激光雷达地面以上高度颜色图

lidar-hag-alternative

替代激光雷达地面以上高度色彩图

lidar-intensity

激光雷达强度色彩图

lidar-returns

激光雷达返回颜色图

magma

Magma colormap - 连续的黑色到黄色颜色图

magma_r

反向岩浆颜色图

modis-10A1

MODIS 10A1 颜色图

modis-10A2

MODIS 10A2 颜色图

modis-13A1|Q1

MODIS 13A1|Q1 颜色图

modis-14A1|A2

MODIS 14A1|A2 颜色图

modis-15A2H|A3H

MODIS 15A2H|A3H 颜色图

modis-16A3GF-ET

MODIS 16A3GF-ET 颜色图

modis-16A3GF-PET

MODIS 16A3GF-PET 颜色图

modis-17A2H|A2HGF

MODIS 17A2H|A2HGF 颜色图

modis-17A3HGF

MODIS 17A3HGF 颜色图

modis-64A1

MODIS 64A1 颜色图

mtbs-severity

MTBS 严重性颜色图

nipy_spectral

Nipy_spectral colormap - 感知均匀的颜色图

nipy_spectral_r

反向 nipy_spectral 颜色图

nrcan-lulc

NRCAN 土地利用/土地覆被色彩图

ocean

海洋颜色图 - 顺序蓝色到白色颜色图

ocean_r

反向海洋色彩图

oranges

橙色颜色图 - 连续的白色到深橙色

oranges_r

反转橙色颜色图

orrd

OrRd 颜色图 - 从白色到深红橙色的顺序

orrd_r

反向 OrRd 颜色图

paired

Paired colormap - 具有不同颜色的定性颜色图

paired_r

反向配对颜色图

pastel1

Pastel1 colormap - 具有柔和色彩的定性色彩图

pastel1_r

反转的 pastel1 颜色图

pastel2

Pastel2 colormap - 具有柔和色彩的定性色彩图

pastel2_r

反向 pastel2 颜色图

pink

粉色颜色图 - 从白色到深粉色的顺序

pink_r

反转的粉红色颜色图

piyg

PiYG 颜色图 - 从粉红色到绿色的发散

piyg_r

反向 PiYG 颜色图

plasma

等离子体颜色图 - 连续的黑色到黄色颜色图

plasma_r

反向等离子体颜色图

prgn

PRGn 颜色图 - 从紫色到绿色发散

prgn_r

反向 PRGn 颜色图

prism

棱柱颜色图 - 具有不同颜色的定性颜色图

prism_r

反转棱柱颜色图

pubu

PuBu 颜色图 - 从白色到深蓝色的顺序

pubu_r

反转 PuBu 颜色图

pubugn

PuBuGn 颜色图 - 从白色到深蓝绿色的顺序

pubugn_r

反向 PuBuGn 颜色图

puor

PuOr 颜色图 - 从紫色发散到橙色

puor_r

反向 PuOr 颜色图

purd

PuRd 颜色图 - 从白色到深紫红色的顺序

purd_r

反向 PuRd 颜色图

purples

紫色颜色图 - 从白色到深紫色的顺序

purples_r

反转紫色颜色图

qpe

QPE colormap - 具有不同颜色的定性颜色图

rainbow

彩虹颜色图 - 具有不同颜色的定性颜色图

rainbow_r

反转彩虹颜色图

rdbu

RdBu 颜色图 - 从红色到蓝色发散

rdbu_r

反向 RdBu 颜色图

rdgy

RdGy 颜色图 - 发散红色到灰色

rdgy_r

反向 RdGy 颜色图

rdpu

RdPu 颜色图 - 从白色到深红紫色的顺序

rdpu_r

反向 RdPu 颜色图

rdylbu

RdYlBu 颜色图 - 发散红色到黄色再到蓝色

rdylbu_r

反转 RdYlBu 颜色图

rdylgn

RdYlGn 颜色图 - 发散红色到黄色再到绿色

rdylgn_r

反向 RdYlGn 颜色图

reds

红色颜色图 - 从白色到深红色的顺序

reds_r

反转红色颜色图

rplumbo

Rplumbo colormap - 具有不同颜色的定性色彩图

schwarzwald

Schwarzwald colormap - 具有不同颜色的定性色彩图

seismic

地震颜色图 - 从蓝色到红色的发散

seismic_r

反向地震色彩图

set1

Set1 colormap - 具有不同颜色的定性颜色图

set1_r

反转的 set1 颜色图

set2

Set2 colormap - 具有不同颜色的定性颜色图

set2_r

反转的 set2 颜色图

set3

Set3 colormap - 具有不同颜色的定性颜色图

set3_r

反转的 set3 颜色图

spectral

光谱颜色图 - 发散红色到黄色再到蓝色

spectral_r

反向光谱颜色图

spring

春季颜色图 - 从洋红色到黄色的顺序

spring_r

反向春季颜色图

summer

夏季颜色图 - 从绿色到黄色的顺序

summer_r

反转夏季色彩图

tab10

Tab10 colormap - 具有不同颜色的定性颜色图

tab10_r

反向 tab10 颜色图

tab20

Tab20 colormap - 具有不同颜色的定性颜色图

tab20_r

反向 tab20 颜色图

tab20b

Tab20b colormap - 具有不同颜色的定性颜色图

tab20b_r

Reversed tab20b 颜色图

tab20c

Tab20c colormap - 具有不同颜色的定性颜色图

tab20c_r

Reversed tab20c 颜色图

terrain

地形颜色图 - 带色相旋转的从黑到白的顺序

terrain_r

Reversed terrain 颜色图

twilight

暮光颜色图 - 从蓝色到红色的发散

twilight_r

反转暮光颜色图

twilight_shifted

暮光之城偏移颜色图 - 蓝色到红色

twilight_shifted_r

反转暮光偏移颜色图

usda-cdl

USDA CDL 色彩图 - 土地覆盖分类

usda-cdl-corn

USDA CDL 玉米颜色图

usda-cdl-cotton

USDA CDL 棉花色图

usda-cdl-soybeans

USDA CDL 大豆颜色图

usda-cdl-wheat

USDA CDL 小麦色图

usgs-lcmap

USGS LCMAP 颜色图

viirs-10a1

VIIRS 10A1 颜色图

viirs-13a1

VIIRS 13A1 颜色图

viirs-14a1

VIIRS 14A1 颜色图

viirs-15a2H

VIIRS 15A2H 颜色图

viridis

Viridis colormap - 连续的黑色到黄色颜色图

viridis_r

Reversed viridis 颜色图

winter

冬季颜色图 - 从蓝色到绿色的顺序

winter_r

反转冬季颜色图

wistia

Wistia 颜色图 - 连续的白色到黄色

wistia_r

反向 wistia 颜色图

ylgn

YlGn 颜色图 - 从白色到深绿色的顺序

ylgn_r

反向 YlGn 颜色图

ylgnbu

YlGnBu 颜色图 - 从白色到深蓝绿色的顺序

ylgnbu_r

反向 YlGnBu 颜色图

ylorbr

YlOrBr 颜色图 - 从白色到深橙棕色的顺序

ylorbr_r

反向 YlOrBr 颜色图

ylorrd

YlOrRd 颜色图 - 从白色到深红橙色的顺序

ylorrd_r

反向 YlOrRd 颜色图

Resampling

以不同分辨率读取源栅格数据时使用的重采样算法

说明
average

平均重采样 - 计算所有参与像素的平均值

bilinear

双线性插值 - 使用 2x2 输入像元的加权平均值计算输出值

cubic

三次插值 - 使用 4x4 输入单元格的加权平均值以获得更平滑的结果

cubic_spline

三次样条插值 - 类似于三次,但更好地保留了边缘

gauss

高斯加权重新采样 - 将高斯加权应用于参与像素

lanczos

Lanczos 窗口 sinc 重采样 - 高质量,最少的伪影

mode

模式重新采样 - 从贡献像素中选择最常见的值

nearest

最邻近 - 选择最接近像素值的最快方法

rms

均方根重采样 - 用于重采样误差或偏差网格