Scenes - Get Stac Feature

Referência

Serviço:: Azure Data Manager for Agriculture

Versão da API:: 2023-04-01-preview

Obtenha um item do catálogo de ativos spatioTemporal (STAC) para determinada coleção e id de recurso.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
collectionId	path	True	collectionId	ID da coleção a ser buscada.
featureId	path	True	string	ID do recurso a ser buscada.
api-version	query	True	string	A versão da API solicitada
providerClientId	query	True	string	ID do cliente do provedor para autenticação no provedor para efetuar pull de dados satélite.
providerClientSecret	query	True	string	Segredo do cliente do provedor para autenticação no provedor para efetuar pull de dados satélite.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Authorization	True	string	Forneça um token de portador válido para chamadas de API autorizadas. Observe que talvez seja necessário limpar o cache do navegador se você tentou chamadas não autenticadas antes.

Respostas

Nome	Tipo	Description
200 OK	StacFeature	Êxito
Other Status Codes	ErrorResponse	Erro Cabeçalhos x-ms-error-code: string

Nome

Tipo

Description

200 OK

StacFeature

Êxito

Other Status Codes

ErrorResponse

Erro

Cabeçalhos

x-ms-error-code: string

Segurança

Authorization

Forneça um token de portador válido para chamadas de API autorizadas. Observe que talvez seja necessário limpar o cache do navegador se você tentou chamadas não autenticadas antes.

Tipo: apiKey
Em: header

Exemplos

Scenes_GetStacFeature

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
    }
  }
}

Definições

Nome	Description
collectionId	ID da coleção a ser buscada.
Error	Um erro do serviço AgPlatform do Azure.
ErrorResponse	Uma resposta de erro do serviço Azure AgPlatform. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses para o documento de referência ErrorResponse.
InnerError	Erro interno que contém a lista de erros. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object para o documento de referência InnerError.
StacFeature	Esquema de recurso STAC(Item). Consulte a especificação: https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#item-fields.
StacFeatureAsset	Esquema do ativo do recurso STAC. Consulte a especificação: https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#asset-object.
StacFeatureLink	O objeto Link descreve uma relação desse Recurso com outra entidade. Consulte a especificação: https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#link-object.

collectionId

Enumeração

ID da coleção a ser buscada.

Valor	Description
Sentinel_2_L1C
Sentinel_2_L2A

Error

Objeto

Um erro do serviço AgPlatform do Azure.

Nome	Tipo	Description
code	string minLength: 1	Conjunto definido pelo servidor de códigos de erro.
details	Error[]	Matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	InnerError	Erro interno que contém a lista de erros. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object para o documento de referência InnerError.
message	string minLength: 1	Representação legível por humanos do erro.
target	string	Destino do erro.

ErrorResponse

Objeto

Uma resposta de erro do serviço Azure AgPlatform. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses para o documento de referência ErrorResponse.

Nome	Tipo	Description
error	Error	Um erro do serviço AgPlatform do Azure.
traceId	string	ID de rastreamento exclusiva.

InnerError

Objeto

Erro interno que contém a lista de erros. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object para o documento de referência InnerError.

Nome	Tipo	Description
code	string	Código de erro específico que foi fornecido pelo erro que contém.
innererror	InnerError	Erro interno que contém a lista de erros. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object para o documento de referência InnerError.

StacFeature

Objeto

Esquema de recurso STAC(Item). Consulte a especificação: https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#item-fields.

Nome	Tipo	Description
assets	<string, StacFeatureAsset>	Dicionário de objetos de ativo, cada um com uma chave exclusiva.
bbox	number[] (double)	Caixa delimitadora do recurso.
collection	string	A ID da coleção STAC que esse recurso faz referência.
geometry	object	Define o volume completo do ativo representado por este item. É uma geometria GeoJSON.
id	string minLength: 1	Identificador do provedor. ID global exclusiva por provedor de dados.
links	StacFeatureLink[]	Lista de objetos de link para recursos e URLs relacionadas.
properties	object	Um dicionário de metadados adicionais para o item.
stacExtensions	string[]	Uma lista de extensões que o Recurso implementa.
stacVersion	string minLength: 1	A versão stac que o recurso implementa.
type	string minLength: 1	Tipo do objeto GeoJSON. Seu valor é sempre Recurso.

StacFeatureAsset

Objeto

Esquema do ativo do recurso STAC. Consulte a especificação: https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#asset-object.

Nome	Tipo	Description
description	string	Uma descrição do Ativo fornecendo detalhes adicionais, como como ele foi processado ou criado.
href	string minLength: 1	Link para o objeto de ativo.
roles	string[]	As funções semânticas do ativo, semelhantes ao uso de rel em links.
title	string	O título exibido para clientes e usuários.
type	string	Tipo de mídia do ativo.

StacFeatureLink

Objeto

O objeto Link descreve uma relação desse Recurso com outra entidade. Consulte a especificação: https://github.com/radiantearth/stac-spec/blob/v1.0.0-beta.2/item-spec/item-spec.md#link-object.

Nome	Tipo	Description
href	string minLength: 1	O link real no formato de uma URL.
rel	string minLength: 1	Relação entre o documento atual e o documento vinculado.
title	string	Um título legível humano a ser usado em exibições renderizadas do link.
type	string	Tipo de mídia da entidade referenciada.

Compartilhar via

Scenes - Get Stac Feature

Parâmetros de URI

Cabeçalho da solicitação

Respostas

Segurança

Authorization

Exemplos

Scenes_GetStacFeature

Solicitação de exemplo

Resposta de exemplo

Definições

collectionId

Error

ErrorResponse

InnerError

StacFeature

StacFeatureAsset

StacFeatureLink