Scenes - Get Stac Feature

Ссылка

Служба:: Azure Data Manager for Agriculture

Версия API:: 2023-04-01-preview

Получение элемента компонента (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	Идентификатор коллекции для получения.
featureId	path	True	string	Идентификатор компонента для получения.
api-version	query	True	string	Запрошенная версия API
providerClientId	query	True	string	Идентификатор клиента поставщика для проверки подлинности поставщика для извлечения спутниковых данных.
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	Идентификатор коллекции для получения.
Error	Ошибка из службы Azure AgPlatform.
ErrorResponse	Ответ об ошибке службы Azure AgPlatform. Справочный документ ErrorResponse см. в https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
InnerError	Внутренняя ошибка, содержащая список ошибок. См. https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object справочный документ InnerError.
StacFeature	Схема компонента STAC (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

Перечисление

Идентификатор коллекции для получения.

Значение	Описание
Sentinel_2_L1C
Sentinel_2_L2A

Error

Object

Ошибка из службы Azure AgPlatform.

Имя	Тип	Описание
code	string minLength: 1	Определяемый сервером набор кодов ошибок.
details	Error[]	Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке.
innererror	InnerError	Внутренняя ошибка, содержащая список ошибок. См. https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object справочный документ InnerError.
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	Уникальный идентификатор трассировки.

InnerError

Object

Внутренняя ошибка, содержащая список ошибок. См. https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object справочный документ InnerError.

Имя	Тип	Описание
code	string	Определенный код ошибки, чем был предоставлен содержащей ошибкой.
innererror	InnerError	Внутренняя ошибка, содержащая список ошибок. См. https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object справочный документ InnerError.

StacFeature

Object

Схема компонента STAC (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, на который ссылается эта функция.
geometry	object	Определяет полный объем ресурса, представленного этим элементом. Его геометрия GeoJSON.
id	string minLength: 1	Идентификатор поставщика. Глобальный уникальный идентификатор поставщика данных.
links	StacFeatureLink[]	Список объектов ссылки на ресурсы и связанные URL-адреса.
properties	object	Словарь дополнительных метаданных для элемента.
stacExtensions	string[]	Список расширений, реализуемых компонентом.
stacVersion	string minLength: 1	Версия STAC, реализуемая компонентом.
type	string minLength: 1	Тип объекта GeoJSON. Это значение всегда является компонентом.

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[]	Семантические роли ресурса, аналогичные использованию ссылок.
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