Scenes - Get Stac Feature

リファレンス

サービス:: Azure Data Manager for Agriculture

API バージョン:: 2023-04-01-preview

特定のコレクションと機能 ID のフィーチャー (SpatioTemporal Asset Catalog (STAC) 項目) を取得します。

GET /scenes/stac-collections/{collectionId}/features/{featureId}?providerClientId={providerClientId}&providerClientSecret={providerClientSecret}&api-version=2023-04-01-preview

URI パラメーター

名前	/	必須	型	説明
collectionId	path	True	collectionId	フェッチされるコレクション ID。
featureId	path	True	string	フェッチされる機能 ID。
api-version	query	True	string	要求された API バージョン
providerClientId	query	True	string	サテライトデータをプルするためにプロバイダーに対して認証するためのプロバイダークライアント ID。
providerClientSecret	query	True	string	サテライトデータをプルするためにプロバイダーに対して認証するためのプロバイダークライアントシークレット。

要求ヘッダー

名前	必須	型	説明
Authorization	True	string	承認された API 呼び出しに有効なベアラートークンを指定してください。以前に認証されていない呼び出しを試した場合は、ブラウザーのキャッシュをクリアする必要がある場合があることに注意してください。

応答

名前	型	説明
200 OK	StacFeature	成功
Other Status Codes	ErrorResponse	エラーヘッダー x-ms-error-code: string

名前

型

説明

200 OK

StacFeature

成功

Other Status Codes

ErrorResponse

エラー

ヘッダー

x-ms-error-code: string

セキュリティ

Authorization

承認された API 呼び出しに有効なベアラートークンを指定してください。以前に認証されていない呼び出しを試した場合は、ブラウザーのキャッシュをクリアする必要がある場合があることに注意してください。

型: apiKey
/: header

例

Scenes_GetStacFeature

要求のサンプル

HTTP

GET /scenes/stac-collections/Sentinel_2_L2A/features/S2A_MSIL2A_20230109T103421_N0509_R108_T32TNT_20230109T134400?providerClientId=client_id&providerClientSecret=client_secret&api-version=2023-04-01-preview

応答のサンプル

状態コード:: 200

{
  "stacVersion": "0.9.0",
  "stacExtensions": [
    "eo",
    "projection"
  ],
  "id": "S2A_MSIL2A_20230109T103421_N0509_R108_T32TNT_20230109T134400",
  "type": "Feature",
  "geometry": {
    "type": "MultiPolygon",
    "crs": {
      "type": "name",
      "properties": {
        "name": "urn:ogc:def:crs:OGC::CRS84"
      }
    },
    "coordinates": [
      [
        [
          [
            8.999746010269414,
            47.85369284359375
          ],
          [
            8.999750703869031,
            46.86660880358706
          ],
          [
            9.233538650114674,
            46.86690684841658
          ],
          [
            9.254835879037781,
            46.920021321987974
          ],
          [
            9.350719551713794,
            47.132406038401356
          ],
          [
            9.395614185456889,
            47.23781757082856
          ],
          [
            9.674442266697191,
            47.85171188149061
          ],
          [
            8.999746010269414,
            47.85369284359375
          ]
        ]
      ]
    ]
  },
  "bbox": [
    8.999746010269414,
    46.86660880358706,
    9.674442266697191,
    47.85369284359375
  ],
  "properties": {
    "datetime": "2023-01-09T10:37:39Z",
    "platform": "sentinel-2a",
    "instruments": [
      "msi"
    ],
    "constellation": "sentinel-2",
    "eo:gsd": 10,
    "eo:cloud_cover": 91.91,
    "eo:bands": [
      {
        "name": "B01",
        "common_name": "coastal",
        "center_wavelength": 0.4427,
        "full_width_half_max": 0.021
      },
      {
        "name": "B02",
        "common_name": "blue",
        "center_wavelength": 0.4924,
        "full_width_half_max": 0.066
      },
      {
        "name": "B03",
        "common_name": "green",
        "center_wavelength": 0.5598,
        "full_width_half_max": 0.036
      },
      {
        "name": "B04",
        "common_name": "red",
        "center_wavelength": 0.6646,
        "full_width_half_max": 0.031
      },
      {
        "name": "B05",
        "center_wavelength": 0.7041,
        "full_width_half_max": 0.015
      },
      {
        "name": "B06",
        "center_wavelength": 0.7405,
        "full_width_half_max": 0.015
      },
      {
        "name": "B07",
        "center_wavelength": 0.7828,
        "full_width_half_max": 0.02
      },
      {
        "name": "B08",
        "common_name": "nir",
        "center_wavelength": 0.8328,
        "full_width_half_max": 0.106
      },
      {
        "name": "B8A",
        "common_name": "nir08",
        "center_wavelength": 0.8647,
        "full_width_half_max": 0.021
      },
      {
        "name": "B09",
        "common_name": "nir09",
        "center_wavelength": 0.9451,
        "full_width_half_max": 0.02
      },
      {
        "name": "B11",
        "common_name": "swir16",
        "center_wavelength": 1.6137,
        "full_width_half_max": 0.091
      },
      {
        "name": "B12",
        "common_name": "swir22",
        "center_wavelength": 2.2024,
        "full_width_half_max": 0.175
      }
    ],
    "proj:epsg": 32632,
    "proj:bbox": [
      499980,
      5190240,
      609780,
      5300040
    ],
    "proj:geometry": {
      "type": "MultiPolygon",
      "crs": {
        "type": "name",
        "properties": {
          "name": "urn:ogc:def:crs:EPSG::32632"
        }
      },
      "coordinates": [
        [
          [
            [
              499981,
              5300039.000221996
            ],
            [
              499981.0000000001,
              5190341.004103656
            ],
            [
              517798.94855620083,
              5190400.59590485
            ],
            [
              519402.9318226095,
              5196307.94891201
            ],
            [
              526597.7017886618,
              5219937.748598386
            ],
            [
              529943.0614761082,
              5231668.36211071
            ],
            [
              550454.252904275,
              5300039.000221933
            ],
            [
              499981,
              5300039.000221996
            ]
          ]
        ]
      ]
    }
  },
  "links": [
    {
      "href": "https://services.sentinel-hub.com/api/v1/catalog/collections/sentinel-2-l2a/items/S2A_MSIL2A_20230109T103421_N0509_R108_T32TNT_20230109T134400",
      "rel": "self",
      "type": "application/json"
    },
    {
      "href": "https://services.sentinel-hub.com/api/v1/catalog/collections/sentinel-2-l2a",
      "rel": "parent"
    },
    {
      "href": "https://scihub.copernicus.eu/dhus/odata/v1/Products('adfbec36-7b33-43ac-b08c-0ea996d97879')/$value",
      "rel": "derived_from",
      "title": "scihub download"
    }
  ],
  "assets": {
    "thumbnail": {
      "href": "https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/32/T/MT/2023/1/4/0/preview.jpg",
      "title": "thumbnail",
      "type": "image/png"
    }
  }
}

定義

名前	説明
collectionId	フェッチされるコレクション ID。
Error	Azure AgPlatform サービスからのエラー。
ErrorResponse	Azure AgPlatform サービスからのエラー応答。 ErrorResponse リファレンスドキュメントについては、https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses を参照してください。
InnerError	エラーの一覧を含む内部エラー。InnerError のリファレンスドキュメントについては、https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object を参照してください。
StacFeature	STAC Feature(Item) のスキーマ。仕様については、https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#item-fieldsを参照してください。
StacFeatureAsset	STAC 機能の資産のスキーマ。仕様については、https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#asset-objectを参照してください。
StacFeatureLink	Link オブジェクトは、このフィーチャーと別のエンティティの関係を表します。仕様については、https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#link-objectを参照してください。

collectionId

列挙

フェッチされるコレクション ID。

値	説明
Sentinel_2_L1C
Sentinel_2_L2A

Error

Object

Azure AgPlatform サービスからのエラー。

名前	型	説明
code	string minLength: 1	サーバー定義のエラーコードのセット。
details	Error[]	この報告されたエラーの原因となった特定のエラーに関する詳細の配列。
innererror	InnerError	エラーの一覧を含む内部エラー。InnerError のリファレンスドキュメントについては、https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object を参照してください。
message	string minLength: 1	エラーの人間が判読できる表現。
target	string	エラーのターゲット。

ErrorResponse

Object

Azure AgPlatform サービスからのエラー応答。 ErrorResponse リファレンスドキュメントについては、https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses を参照してください。

名前	型	説明
error	Error	Azure AgPlatform サービスからのエラー。
traceId	string	一意のトレース ID。

InnerError

Object

エラーの一覧を含む内部エラー。InnerError のリファレンスドキュメントについては、https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object を参照してください。

名前	型	説明
code	string	含まれているエラーによって提供されたエラーコードよりも具体的なエラーコード。
innererror	InnerError	エラーの一覧を含む内部エラー。InnerError のリファレンスドキュメントについては、https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object を参照してください。

StacFeature

Object

STAC Feature(Item) のスキーマ。仕様については、https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#item-fieldsを参照してください。

名前	型	説明
assets	<string, StacFeatureAsset>	資産オブジェクトのディクショナリ。それぞれが一意のキーを持ちます。
bbox	number[] (double)	フィーチャの境界ボックス。
collection	string	このフィーチャーが参照する STAC コレクションの ID。
geometry	object	この項目によって表される資産の完全なフットプリントを定義します。その GeoJSON ジオメトリ。
id	string minLength: 1	プロバイダー識別子。データプロバイダー別のグローバルに一意の ID。
links	StacFeatureLink[]	リソースと関連 URL へのリンクオブジェクトの一覧。
properties	object	項目の追加メタデータのディクショナリ。
stacExtensions	string[]	フィーチャーが実装する拡張機能の一覧。
stacVersion	string minLength: 1	フィーチャーが実装する STAC バージョン。
type	string minLength: 1	GeoJSON オブジェクトの型。値は常に Feature です。

StacFeatureAsset

Object

STAC 機能の資産のスキーマ。仕様については、https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#asset-objectを参照してください。

名前	型	説明
description	string	資産が処理または作成された方法など、追加の詳細を提供する資産の説明。
href	string minLength: 1	アセットオブジェクトにリンクします。
roles	string[]	リンクでの rel の使用と同様に、資産のセマンティックロール。
title	string	クライアントとユーザーに表示されるタイトル。
type	string	資産のメディアの種類。

StacFeatureLink

Object

Link オブジェクトは、このフィーチャーと別のエンティティの関係を表します。仕様については、https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#link-objectを参照してください。

名前	型	説明
href	string minLength: 1	URL の形式の実際のリンク。
rel	string minLength: 1	現在のドキュメントとリンクされたドキュメントの間のリレーションシップ。
title	string	リンクのレンダリングされたディスプレイで使用される人間が判読できるタイトル。
type	string	参照先エンティティのメディアの種類。

次の方法で共有

Scenes - Get Stac Feature

URI パラメーター

要求ヘッダー

応答

セキュリティ

Authorization

例

Scenes_GetStacFeature

要求のサンプル

応答のサンプル

定義

collectionId

Error

ErrorResponse

InnerError

StacFeature

StacFeatureAsset

StacFeatureLink