Stac Collection Render Options - Create

サービス:: Planetary Computer

API バージョン:: 2025-04-30-preview

コレクションレンダリングオプションを追加
特定のコレクションのレンダリングオプションを追加する

POST https:///stac/collections/{collectionId}/configurations/render-options?api-version=2025-04-30-preview

URI パラメーター

名前	/	必須	型	説明
collectionId	path	True	string maxLength: 500 pattern: .*	STAC コレクションの一意の識別子。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
id	True	string minLength: 1 maxLength: 30 pattern: ^(?!\-\|_)[a-zA-Z0-9_-]*(?	レンダリングオプションの一意の識別子。
name	True	string maxLength: 40	レンダリングオプションの短い説明名。
conditions		RenderOptionCondition[]	このレンダリング・オプションを有効にするためにアクティブ・モザイクCQLに含まれている必要があるプロパティ/値条件のリスト
description		string	レンダリングオプションの内容を説明するために使用できる詳細な説明。
legend		RenderOptionLegend	このレンダリングオプションの凡例設定。
minZoom		integer (int32) maximum: 24	このレイヤーを表示する最小ズームレベル。
options		string	TiTiler レンダリングオプションの URL クエリ文字列でエンコードされた文字列。 `raster-tile`タイプにのみ有効です。クエリパラメータを参照してください。
type		RenderOptionType	適用するレンダリングのタイプ(ラスターまたはベクター)。
vectorOptions		RenderOptionVectorOptions	ベクタータイルをレンダリングするためのオプション。 `vt-polygon`タイプと`vt-line`タイプにのみ有効です。

応答

名前	型	説明
201 Created	RenderOption	要求が成功し、結果として新しいリソースが作成されました。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	予期しないエラー応答。ヘッダー x-ms-error-code: string

名前

型

説明

201 Created

RenderOption

要求が成功し、結果として新しいリソースが作成されました。

Other Status Codes

Azure.Core.Foundations.ErrorResponse

予期しないエラー応答。

ヘッダー

x-ms-error-code: string

セキュリティ

OAuth2Auth

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
https://geocatalog.spatio.azure.com/.default

例

StacCollectionRenderOptions_Create

要求のサンプル

HTTP

POST https:///stac/collections/naip-atl/configurations/render-options?api-version=2025-04-30-preview

{
  "id": "test-natural-color",
  "name": "Test Natural color",
  "type": "raster-tile",
  "options": "assets=image&asset_bidx=image|1,2,3",
  "minZoom": 6
}

応答のサンプル

状態コード:: 201

{
  "id": "test-natural-color",
  "name": "Test Natural color",
  "type": "raster-tile",
  "options": "assets=image&asset_bidx=image|1,2,3",
  "minZoom": 6
}

定義

名前	説明
Azure.Core.Foundations.Error	エラーオブジェクト。
Azure.Core.Foundations.ErrorResponse	エラーの詳細を含む応答。
Azure.Core.Foundations.InnerError	エラーに関するより具体的な情報を含むオブジェクト。 Azure REST API ガイドライン - https://aka.ms/AzureRestApiGuidelines#handling-errorsに準拠。
LegendConfigType	作成する凡例の種類: `continuous`、 `classmap`、 `interval` 、または `none` のいずれか ( `none` は文字列リテラルであることに注意してください)。
RenderOption	マップ上にデータをレンダリングするための視覚化パラメーターを定義します。
RenderOptionCondition	レンダリングオプションを有効にするための条件を定義します。
RenderOptionLegend	データ凡例を生成するための構成。
RenderOptionType	マップビジュアリゼーションのレンダリングオプションの種類を指定します。
RenderOptionVectorOptions	ベクタータイルレンダリングのパラメーターを定義します。

Azure.Core.Foundations.Error

Object

エラーオブジェクト。

名前	型	説明
code	string	サーバー定義の一連のエラーコードの 1 つ。
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

エラーに関するより具体的な情報を含むオブジェクト。 Azure REST API ガイドライン - https://aka.ms/AzureRestApiGuidelines#handling-errorsに準拠。

名前	型	説明
code	string	サーバー定義の一連のエラーコードの 1 つ。
innererror	Azure.Core.Foundations.InnerError	内部エラー。

LegendConfigType

列挙

作成する凡例の種類: continuous、 classmap、 interval 、または none のいずれか ( none は文字列リテラルであることに注意してください)。

値	説明
continuous	連続カラーランプの凡例。
classmap	クラスの個別の色を持つ分類済みマップ。
interval	離散範囲を持つ間隔ベースの凡例。
none	伝説はありません。

RenderOption

Object

マップ上にデータをレンダリングするための視覚化パラメーターを定義します。

名前	型	規定値	説明
conditions	RenderOptionCondition[]		このレンダリング・オプションを有効にするためにアクティブ・モザイクCQLに含まれている必要があるプロパティ/値条件のリスト
description	string		レンダリングオプションの内容を説明するために使用できる詳細な説明。
id	string minLength: 1 maxLength: 30 pattern: ^(?!\-\|_)[a-zA-Z0-9_-]*(?		レンダリングオプションの一意の識別子。
legend	RenderOptionLegend		このレンダリングオプションの凡例設定。
minZoom	integer (int32) maximum: 24	12	このレイヤーを表示する最小ズームレベル。
name	string maxLength: 40		レンダリングオプションの短い説明名。
options	string		TiTiler レンダリングオプションの URL クエリ文字列でエンコードされた文字列。 `raster-tile`タイプにのみ有効です。クエリパラメータを参照してください。
type	RenderOptionType	raster-tile	適用するレンダリングのタイプ(ラスターまたはベクター)。
vectorOptions	RenderOptionVectorOptions		ベクタータイルをレンダリングするためのオプション。 `vt-polygon`タイプと`vt-line`タイプにのみ有効です。

RenderOptionCondition

Object

レンダリングオプションを有効にするための条件を定義します。

名前	型	説明
property	string	アクティブなCQLフィルターをチェックインするプロパティ名。
value	string	プロパティが等しくなければならない値。

RenderOptionLegend

Object

データ凡例を生成するための構成。

名前	型	説明
labels	string[]	凡例に表示するテキストラベル。
scaleFactor	number (float)	間隔の凡例ラベルに乗算する係数。カラーマップ定義がスケーリングされていない値にマッピングされるスケーリングされたラスターに役立ち、凡例ラベルをスケーリングされた値として効果的に表示します。
trimEnd	integer (int32)	凡例の末尾からトリミングする項目の数。
trimStart	integer (int32)	凡例定義の先頭からトリムする項目の数。レンダリングに重要な値 (nodata など) があり、凡例では望ましくない場合に使用されます。
type	LegendConfigType	作成する凡例の種類: `continuous`、 `classmap`、 `interval` 、または `none` のいずれか ( `none` は文字列リテラルであることに注意してください)。

RenderOptionType

列挙

マップビジュアリゼーションのレンダリングオプションの種類を指定します。

値	説明
raster-tile	ラスタータイルレンダリングタイプ。
vt-polygon	ベクタータイルポリゴンのレンダリングタイプ。
vt-line	ベクタータイルラインレンダリングタイプ。

RenderOptionVectorOptions

Object

ベクタータイルレンダリングのパラメーターを定義します。

名前	型	説明
fillColor	string	ポリゴンフィーチャの塗りつぶし色。
filter	string[]	MapBox GLフィルター式を使用して、フィーチャをフィルタリングします。
sourceLayer	string	ベクタータイル内のソースレイヤーの名前。
strokeColor	string	ラインの特徴のストロークの色。
strokeWidth	integer (int32)	線ストロークの幅 (ピクセル単位)。
tilejsonKey	string	TileJSON URL を含むアセットキー。

次の方法で共有

Stac Collection Render Options - Create

URI パラメーター

要求本文

応答

セキュリティ

OAuth2Auth

スコープ

例

StacCollectionRenderOptions_Create

要求のサンプル

応答のサンプル

定義

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

LegendConfigType

RenderOption

RenderOptionCondition

RenderOptionLegend

RenderOptionType

RenderOptionVectorOptions