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

Tiler Tile Json Operations - Get

参考

服务:: Planetary Computer

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

返回 tilejson

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/tilejson.json?api-version=2025-04-30-preview

具有可选参数:

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/items/{itemId}/tilejson.json?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}&tileMatrixSetId={tileMatrixSetId}&tile_format={tile_format}&tile_scale={tile_scale}&minzoom={minzoom}&maxzoom={maxzoom}&buffer={buffer}&color_formula={color_formula}&resampling={resampling}&rescale={rescale}&colormap_name={colormap_name}&colormap={colormap}&return_mask={return_mask}

URI 参数

名称	在	必需	类型	说明
collectionId	path	True	string maxLength: 500 pattern: .*	STAC 集合标识符
itemId	path	True	string maxLength: 500 pattern: .*	STAC 项标识符
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	资产之间的波段数学表达式
maxzoom	query		integer (int32)	覆盖默认 maxzoom。
minzoom	query		integer (int32)	覆盖默认 minzoom。
nodata	query		number (float)	覆盖内部 Nodata 值
resampling	query		Resampling	重新采样方法。
rescale	query		string[]	逗号（'，'）分隔 Min，Max 范围。可以为多个波段设置多个时间。
return_mask	query		boolean	将掩码添加到输出数据。
tile_format	query		ImageType	如果输出图像需要蒙版（png）或不需要（jpeg），将自动定义默认值。
tile_scale	query		integer (int32)	影响输出大小的平铺比例因子。值 > 1 生成更大的图块（例如，1=256x256、2=512x512）。
tileMatrixSetId	query		Tilematrixsetid	选择支持的 TileMatrixSetId 之一的标识符（默认值：'WebMercatorQuad'）
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

示例

TilerTileJsonOperations_Get

示例请求

HTTP

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{{collectionId}}/items/{{itemId}}/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	磁贴和图像请求的图像格式说明符
Resampling	以不同分辨率读取源栅格数据时使用的重采样算法
TileJsonResponse	TileJSON 模型。基于 https://github.com/mapbox/tilejson-spec/tree/master/2.2.0TileJSON 根据 TileJSON 规范描述图块集的元数据
TileJsonScheme	TileJSON 规范中的瓦片寻址方案
Tilematrixsetid	标识符选择支持的 TileMatrixSetId 之一（默认值：'WebMercatorQuad'）用于提供地图瓦片的坐标参考系统和切片方案的标准标识符

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 格式 - 压缩良好的现代图像格式

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 瓦片寻址方案

Tilematrixsetid

枚举

标识符选择支持的 TileMatrixSetId 之一（默认值：'WebMercatorQuad'）用于提供地图瓦片的坐标参考系统和切片方案的标准标识符

值	说明
CanadianNAD83_LCC	加拿大 NAD83 Lambert 等角圆锥投影瓦片矩阵集
EuropeanETRS89_LAEAQuad	欧洲 ETRS89 兰伯方位等积四边形平铺矩阵集
LINZAntarticaMapTilegrid	Land Information 新西兰（LINZ）南极洲地图瓦片网格矩阵集
NZTM2000Quad	新西兰横轴墨卡托 2000 四块瓦片矩阵集
UPSAntarcticWGS84Quad	通用极地立体南极 WGS84 四分块矩阵集
UPSArcticWGS84Quad	通用极地立体极地 WGS84 四平铺矩阵套装
UTM31WGS84Quad	通用横轴墨卡托区域 31 WGS84 四分块矩阵集
WGS1984Quad	WGS 1984 四分块矩阵集
WebMercatorQuad	Web 墨卡托四边形图块矩阵集
WorldCRS84Quad	世界 CRS84 四分块矩阵集
WorldMercatorWGS84Quad	世界墨卡托 WGS84 四边形图块矩阵集

通过

Tiler Tile Json Operations - Get

URI 参数

响应

安全性

OAuth2Auth

作用域

示例

TilerTileJsonOperations_Get

示例请求

示例响应

定义

Algorithm

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

ColorMapNames

ImageType

Resampling

TileJsonResponse

TileJsonScheme

Tilematrixsetid