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

Mosaics Tile Matrix Sets Tile Json - Get

参考

服务:: Planetary Computer

API 版本:: 2025-04-30-preview

tilejson tilematrixsetid 作为路径
返回 searchId 的 TileJSON 文档。

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/mosaic/{searchId}/{tileMatrixSetId}/tilejson.json?api-version=2025-04-30-preview

具有可选参数:

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/mosaic/{searchId}/{tileMatrixSetId}/tilejson.json?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}&minzoom={minzoom}&maxzoom={maxzoom}&tile_format={tile_format}&tile_scale={tile_scale}&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}

URI 参数

名称	在	必需	类型	说明
searchId	path	True	string maxLength: 500 pattern: .*	搜索 ID（pgSTAC 搜索哈希）
tileMatrixSetId	path	True	string maxLength: 500 pattern: .*	标识符选择支持的 TileMatrixSetId 之一
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）。
collection	query		string	STAC 系列 ID
color_formula	query		string	rio-color 公式（信息： https://github.com/mapbox/rio-color）
colormap	query		string	JSON 编码的自定义颜色图
colormap_name	query		ColorMapNames	颜色图名称
exitwhenfull	query		boolean	一旦几何图形被完全覆盖，就返回（在 PgSTAC 中默认为 True）。
expression	query		string	资产之间的波段数学表达式
items_limit	query		integer (int32)	一旦每个几何体有 N 个项目（在 PgSTAC 中默认为 100），就返回。
maxzoom	query		integer (int32)	覆盖默认 maxzoom。
minzoom	query		integer (int32)	覆盖默认 minzoom。
nodata	query		number (float)	覆盖内部 Nodata 值
pixel_selection	query		PixelSelection	像素选择方法。
resampling	query		Resampling	重新采样方法。
rescale	query		string[]	逗号（'，'）分隔 Min，Max 范围。可以为多个波段设置多个时间。
return_mask	query		boolean	将掩码添加到输出数据。
scan_limit	query		integer (int32)	扫描 N 项后立即返回（在 PgSTAC 中默认为 10000）。
skipcovered	query		boolean	跳过完全显示在先前项目下的任何项目（在 PgSTAC 中默认为 True）。
tile_format	query		ImageType	如果输出图像需要蒙版（png）或不需要（jpeg），将自动定义默认值。
tile_scale	query		integer (int32)	影响输出大小的平铺比例因子。值 > 1 生成更大的图块（例如，1=256x256、2=512x512）。
time_limit	query		integer (int32)	在 N 秒后返回以避免长请求（在 PgSTAC 中默认为 5）。
unscale	query		boolean	应用内部缩放或偏移

响应

名称	类型	说明
200 OK	TileJsonResponse	请求已成功。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	意外的错误响应。标头 x-ms-error-code: string

名称

类型

说明

200 OK

TileJsonResponse

请求已成功。

Other Status Codes

Azure.Core.Foundations.ErrorResponse

意外的错误响应。

标头

x-ms-error-code: string

安全性

OAuth2Auth

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

作用域

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

示例

MosaicsTileMatrixSetsTileJson_Get

示例请求

HTTP

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

示例响应

状态代码:: 200

{
  "tilejson": "2.2.0",
  "version": "1.0.0",
  "scheme": "xyz",
  "tiles": [
    "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/data/collections/test-collection-0df36a74d7ed/items/test-item-0df36a74d7ed/tiles/WebMercatorQuad/{z}/{x}/{y}@1x?assets=data"
  ],
  "minzoom": 0,
  "maxzoom": 24,
  "bounds": [
    -65.75386020444417,
    18.252569552371305,
    -65.75376429311993,
    18.252661191551685
  ],
  "center": [
    -65.75381224878205,
    18.252615371961497,
    0
  ]
}

定义

名称	说明
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	用于数据可视化的可用彩色图
ImageType	磁贴和图像请求的图像格式说明符
PixelSelection	标识符选择支持的 TileMatrixSetId 之一（默认值：'WebMercatorQuad'）标识符选择支持的 TileMatrixSetId 之一（默认值：'WebMercatorQuad'）从多个源创建合成时用于选择或计算像素的方法
Resampling	以不同分辨率读取源栅格数据时使用的重采样算法
TileJsonResponse	TileJSON 模型。基于 https://github.com/mapbox/tilejson-spec/tree/master/2.2.0TileJSON 根据 TileJSON 规范描述图块集的元数据
TileJsonScheme	TileJSON 规范中的瓦片寻址方案

Algorithm

枚举

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

值	说明
contours	生成高程等值线
hillshade	根据高程数据创建山体阴影可视化
normalizedIndex	计算波段之间的标准化差值指数
terrainrgb	以 Mapbox TerrainRGB 格式对高程数据进行编码
terrarium	以 Mapbox Terrarium RGB 格式对高程数据进行编码

Azure.Core.Foundations.Error

Object

错误对象。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
details	Azure.Core.Foundations.Error[]	导致此报告错误的特定错误的详细信息数组。
innererror	Azure.Core.Foundations.InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	有关错误的可读的表示形式。
target	string	错误的目标。

Azure.Core.Foundations.ErrorResponse

Object

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

名称	类型	说明
error	Azure.Core.Foundations.Error	错误对象。

Azure.Core.Foundations.InnerError

Object

包含有关错误的更具体信息的对象。根据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 颜色图

ImageType

枚举

磁贴和图像请求的图像格式说明符

值	说明
jp2	JPEG 2000 格式 - 支持有损和无损压缩
jpeg	JPEG 格式 - 文件大小较小但有损压缩
jpg	JPEG 格式的替代扩展名
npy	用于原始数据访问的 NumPy 数组格式
png	可移植网络图形格式 - 支持透明度
pngraw	用于访问未处理数据的原始 PNG 格式
tif	地理配准栅格数据的 GeoTIFF 格式
webp	WebP 格式 - 压缩良好的现代图像格式

PixelSelection

枚举

标识符选择支持的 TileMatrixSetId 之一（默认值：'WebMercatorQuad'）标识符选择支持的 TileMatrixSetId 之一（默认值：'WebMercatorQuad'）从多个源创建合成时用于选择或计算像素的方法

值	说明
first	从第一个可用图像中选择像素
highest	选择值最高的像素
lastbandhight	选择最后一个波段中具有最高值的图像
lastbandlow	选择最后一个区间中值最低的图像
lowest	选择值最低的像素
mean	计算可用像素的平均值
median	计算可用像素的中位数
stdev	计算可用像素的标准差

Resampling

枚举

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

值	说明
average	平均重采样 - 计算所有参与像素的平均值
bilinear	双线性插值 - 使用 2x2 输入像元的加权平均值计算输出值
cubic	三次插值 - 使用 4x4 输入单元格的加权平均值以获得更平滑的结果
cubic_spline	三次样条插值 - 类似于三次，但更好地保留了边缘
gauss	高斯加权重新采样 - 将高斯加权应用于参与像素
lanczos	Lanczos 窗口 sinc 重采样 - 高质量，最少的伪影
mode	模式重新采样 - 从贡献像素中选择最常见的值
nearest	最邻近 - 选择最接近像素值的最快方法
rms	均方根重采样 - 用于重采样误差或偏差网格

TileJsonResponse

Object

TileJSON 模型。

基于 https://github.com/mapbox/tilejson-spec/tree/master/2.2.0TileJSON 根据 TileJSON 规范描述图块集的元数据

名称	类型	默认值	说明
attribution	string		数据源的归因文本
bounds	number[] (float)	[ -180, -90, 180, 90 ]	边界
center	number[] (float)		图块集的默认中心点 [经度、纬度、缩放]
data	string[]		数据文件 URL 模板数组
description	string		图块集的人类可读描述
grids	string[]		UTFGrid URL 模板数组
legend	string		图块集的图例内容的 URL
maxzoom	integer (int32) maximum: 30	30	图块集中可用的最大缩放级别
minzoom	integer (int32) maximum: 30		图块集中可用的最小缩放级别
name	string		图块集的可读名称
scheme	TileJsonScheme	xyz	切片寻址方案（xyz 或 tms）
template	string		特征信息查询的 URL 模板
tilejson	string	2.2.0	瓦片json
tiles	string[]		磁贴 URL 模板数组
version	string	1.0.0	版本

TileJsonScheme

枚举

TileJSON 规范中的瓦片寻址方案

值	说明
tms	原点位于左下角的 TMS 平铺寻址方案
xyz	原点位于左上角的 XYZ 瓦片寻址方案

通过

Mosaics Tile Matrix Sets Tile Json - Get

URI 参数

响应

安全性

OAuth2Auth

作用域

示例

MosaicsTileMatrixSetsTileJson_Get

示例请求

示例响应

定义

Algorithm

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

ColorMapNames

ImageType

PixelSelection

Resampling

TileJsonResponse

TileJsonScheme