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 參數

名稱	位於	必要	類型	Description
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	應用內部縮放或偏移

回應

名稱	類型	Description
200 OK	TileJsonResponse	要求已成功。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	未預期的錯誤回應。 標題 x-ms-error-code: string

安全性

OAuth2Auth

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
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
  ]
}

定義

名稱	Description
Algorithm	基於 terrain 和索引的分析支持的演算法
Azure.Core.Foundations.Error	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 和索引的分析支持的演算法

值	Description
contours	生成高程等值線
hillshade	根據高程數據創建山體陰影可視化
normalizedIndex	計算波段之間的標準化差值指數
terrainrgb	以 Mapbox TerrainRGB 格式對高程數據進行編碼
terrarium	以 Mapbox Terrarium RGB 格式對高程數據進行編碼

Azure.Core.Foundations.Error

Object

error 物件。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
details	Azure.Core.Foundations.Error[]	導致此錯誤之特定錯誤的詳細數據陣列。
innererror	Azure.Core.Foundations.InnerError	物件，包含與目前對象有關錯誤更具體的資訊。
message	string	錯誤的人類可讀取表示法。
target	string	錯誤的目標。

Azure.Core.Foundations.ErrorResponse

Object

包含錯誤詳細數據的回應。

名稱	類型	Description
error	Azure.Core.Foundations.Error	error 物件。

Azure.Core.Foundations.InnerError

Object

物件，包含有關錯誤的更特定資訊。 根據Microsoft一個 API 指導方針 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
innererror	Azure.Core.Foundations.InnerError	內部錯誤。

ColorMapNames

列舉型別

用於數據可視化的可用彩色圖

值	Description
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

列舉型別

磁貼和圖像請求的圖像格式說明符

值	Description
jp2	JPEG 2000 格式 - 支援有損和無損壓縮
jpeg	JPEG 格式 - 檔案大小較小但有損壓縮
jpg	JPEG 格式的替代擴展名
npy	用於原始數據訪問的 NumPy 數位格式
png	可移植網路圖形格式 - 支援透明度
pngraw	用於訪問未處理數據的原始 PNG 格式
tif	地理配準柵格數據的 GeoTIFF 格式
webp	WebP 格式 - 壓縮良好的現代圖像格式

PixelSelection

列舉型別

標識符選擇支援的 TileMatrixSetId 之一（預設值：'WebMercatorQuad'）標識符選擇支援的 TileMatrixSetId 之一（預設值：'WebMercatorQuad'）從多個源創建合成時用於選擇或計算圖元的方法

值	Description
first	從第一個可用圖像中選擇圖元
highest	選擇值最高的圖元
lastbandhight	選擇最後一個波段中具有最高值的圖像
lastbandlow	選擇最後一個區間中值最低的圖像
lowest	選擇值最低的圖元
mean	計算可用圖元的平均值
median	計算可用圖元的中位數
stdev	計算可用圖元的標準差

Resampling

列舉型別

以不同解析度讀取源柵格數據時使用的重採樣演算法

值	Description
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 規範描述圖塊集的元數據

名稱	類型	預設值	Description
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 規範中的瓦片尋址方案

值	Description
tms	原點位於左下角的TMS平鋪尋址方案
xyz	原點位於左上角的 XYZ 瓦片尋址方案