Stac Search Operations - Create

Referenz

Dienst:: Planetary Computer

API-Version:: 2025-04-30-preview

Suche
Endpunkt.

POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/search?api-version=2025-04-30-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
bbox	number[] (double)	Begrenzungsrahmen für die räumliche Filterung im Format [West, Süd, Ost, Nord].
collections	string[]	Liste der Sammlungs-IDs, in denen gesucht werden soll.
conf	object	Conf
datetime	string	Der zeitliche Filter im RFC 3339-Format kann eine einzelne Zeit oder ein Bereich sein.
duration	integer (int32)	Dauer der URL-Signatur in Sekunden.
fields	SearchPostRequestFields[]	https://github.com/stac-api-extensions/fields Gibt an, welche Felder in die Antwort ein- oder ausgeschlossen werden sollen.
filter	object	https://github.com/stac-api-extensions/filter Filter
filter-crs	string	Koordinatenreferenzsystem für den Filter.
filter-lang	FilterLang	Filtersprache, die für den Filterausdruck verwendet werden soll.
ids	string[]	Liste der spezifischen Element-IDs, die zurückgegeben werden sollen.
intersects	GeoJson	GeoJSON-Geometrie für die räumliche Filterung.
limit	integer (int32) minimum: 1 maximum: 1000	Maximale Anzahl der zurückzugebenden Ergebnisse.
query	object	https://github.com/stac-api-extensions/query Abfrage
sign	SignType	Gibt an, ob Asset-URLs in der Antwort signiert werden sollen.
sortby	SortExtension[]	https://github.com/stac-api-extensions/sort Sortierkriterien für die Suchergebnisse.
token	string	Paginierungstoken zum Abrufen des nächsten Satzes von Ergebnissen.

Antworten

Name	Typ	Beschreibung
200 OK	ItemCollection	Die Anforderung ist erfolgreich.
204 No Content		Es gibt keinen Inhalt, der für diese Anforderung gesendet werden soll, aber die Header können nützlich sein.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

ItemCollection

Die Anforderung ist erfolgreich.

204 No Content

Es gibt keinen Inhalt, der für diese Anforderung gesendet werden soll, aber die Header können nützlich sein.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Unerwartete Fehlerantwort.

Header

x-ms-error-code: string

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
https://geocatalog.spatio.azure.com/.default

Beispiele

StacSearchOperations_Create

Beispielanforderung

HTTP

POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/search?api-version=2025-04-30-preview

{
  "bbox": [
    -89.940948,
    28.887969,
    -88.938446,
    29.623609
  ],
  "collections": [
    "sentinel-2-l2a-test-collection-0101d529594b"
  ]
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "type": "FeatureCollection",
  "features": [
    {
      "id": "S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120",
      "bbox": [
        -89.06959008,
        28.82389372,
        -87.92460396,
        29.82716844
      ],
      "type": "Feature",
      "links": [
        {
          "rel": "collection",
          "type": "application/json",
          "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/sentinel-2-l2a-test-collection-0101d529594b"
        },
        {
          "rel": "parent",
          "type": "application/json",
          "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/sentinel-2-l2a-test-collection-0101d529594b"
        },
        {
          "rel": "root",
          "type": "application/json",
          "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/"
        },
        {
          "rel": "self",
          "type": "application/geo+json",
          "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/sentinel-2-l2a-test-collection-0101d529594b/items/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120"
        },
        {
          "rel": "license",
          "href": "https://sentinel.esa.int/documents/247904/690755/Sentinel_Data_Legal_Notice"
        },
        {
          "rel": "preview",
          "href": "https://planetarycomputer.microsoft.com/api/data/v1/item/map?collection=sentinel-2-l2a&item=S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120",
          "type": "text/html",
          "title": "Map of item"
        }
      ],
      "assets": {
        "AOT": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/AOT.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            10980,
            10980
          ],
          "proj:transform": [
            10,
            0,
            300000,
            0,
            -10,
            3300000
          ],
          "gsd": 10,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Aerosol optical thickness (AOT)"
        },
        "B01": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B01.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            1830,
            1830
          ],
          "proj:transform": [
            60,
            0,
            300000,
            0,
            -60,
            3300000
          ],
          "gsd": 60,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 1 - Coastal aerosol - 60m",
          "eo:bands": [
            {
              "name": "B01",
              "common_name": "coastal",
              "description": "Band 1 - Coastal aerosol",
              "center_wavelength": 0.443,
              "full_width_half_max": 0.027
            }
          ]
        },
        "B02": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B02.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            10980,
            10980
          ],
          "proj:transform": [
            10,
            0,
            300000,
            0,
            -10,
            3300000
          ],
          "gsd": 10,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 2 - Blue - 10m",
          "eo:bands": [
            {
              "name": "B02",
              "common_name": "blue",
              "description": "Band 2 - Blue",
              "center_wavelength": 0.49,
              "full_width_half_max": 0.098
            }
          ]
        },
        "B03": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B03.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            10980,
            10980
          ],
          "proj:transform": [
            10,
            0,
            300000,
            0,
            -10,
            3300000
          ],
          "gsd": 10,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 3 - Green - 10m",
          "eo:bands": [
            {
              "name": "B03",
              "common_name": "green",
              "description": "Band 3 - Green",
              "center_wavelength": 0.56,
              "full_width_half_max": 0.045
            }
          ]
        },
        "B04": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B04.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            10980,
            10980
          ],
          "proj:transform": [
            10,
            0,
            300000,
            0,
            -10,
            3300000
          ],
          "gsd": 10,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 4 - Red - 10m",
          "eo:bands": [
            {
              "name": "B04",
              "common_name": "red",
              "description": "Band 4 - Red",
              "center_wavelength": 0.665,
              "full_width_half_max": 0.038
            }
          ]
        },
        "B05": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B05.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            5490,
            5490
          ],
          "proj:transform": [
            20,
            0,
            300000,
            0,
            -20,
            3300000
          ],
          "gsd": 20,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 5 - Vegetation red edge 1 - 20m",
          "eo:bands": [
            {
              "name": "B05",
              "common_name": "rededge",
              "description": "Band 5 - Vegetation red edge 1",
              "center_wavelength": 0.704,
              "full_width_half_max": 0.019
            }
          ]
        },
        "B06": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B06.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            5490,
            5490
          ],
          "proj:transform": [
            20,
            0,
            300000,
            0,
            -20,
            3300000
          ],
          "gsd": 20,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 6 - Vegetation red edge 2 - 20m",
          "eo:bands": [
            {
              "name": "B06",
              "common_name": "rededge",
              "description": "Band 6 - Vegetation red edge 2",
              "center_wavelength": 0.74,
              "full_width_half_max": 0.018
            }
          ]
        },
        "B07": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B07.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            5490,
            5490
          ],
          "proj:transform": [
            20,
            0,
            300000,
            0,
            -20,
            3300000
          ],
          "gsd": 20,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 7 - Vegetation red edge 3 - 20m",
          "eo:bands": [
            {
              "name": "B07",
              "common_name": "rededge",
              "description": "Band 7 - Vegetation red edge 3",
              "center_wavelength": 0.783,
              "full_width_half_max": 0.028
            }
          ]
        },
        "B08": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B08.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            10980,
            10980
          ],
          "proj:transform": [
            10,
            0,
            300000,
            0,
            -10,
            3300000
          ],
          "gsd": 10,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 8 - NIR - 10m",
          "eo:bands": [
            {
              "name": "B08",
              "common_name": "nir",
              "description": "Band 8 - NIR",
              "center_wavelength": 0.842,
              "full_width_half_max": 0.145
            }
          ]
        },
        "B09": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B09.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            1830,
            1830
          ],
          "proj:transform": [
            60,
            0,
            300000,
            0,
            -60,
            3300000
          ],
          "gsd": 60,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 9 - Water vapor - 60m",
          "eo:bands": [
            {
              "name": "B09",
              "description": "Band 9 - Water vapor",
              "center_wavelength": 0.945,
              "full_width_half_max": 0.026
            }
          ]
        },
        "B11": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B11.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            5490,
            5490
          ],
          "proj:transform": [
            20,
            0,
            300000,
            0,
            -20,
            3300000
          ],
          "gsd": 20,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 11 - SWIR (1.6) - 20m",
          "eo:bands": [
            {
              "name": "B11",
              "common_name": "swir16",
              "description": "Band 11 - SWIR (1.6)",
              "center_wavelength": 1.61,
              "full_width_half_max": 0.143
            }
          ]
        },
        "B12": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B12.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            5490,
            5490
          ],
          "proj:transform": [
            20,
            0,
            300000,
            0,
            -20,
            3300000
          ],
          "gsd": 20,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 12 - SWIR (2.2) - 20m",
          "eo:bands": [
            {
              "name": "B12",
              "common_name": "swir22",
              "description": "Band 12 - SWIR (2.2)",
              "center_wavelength": 2.19,
              "full_width_half_max": 0.242
            }
          ]
        },
        "B8A": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/B8A.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            5490,
            5490
          ],
          "proj:transform": [
            20,
            0,
            300000,
            0,
            -20,
            3300000
          ],
          "gsd": 20,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Band 8A - Vegetation red edge 4 - 20m",
          "eo:bands": [
            {
              "name": "B8A",
              "common_name": "rededge",
              "description": "Band 8A - Vegetation red edge 4",
              "center_wavelength": 0.865,
              "full_width_half_max": 0.033
            }
          ]
        },
        "SCL": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/SCL.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            5490,
            5490
          ],
          "proj:transform": [
            20,
            0,
            300000,
            0,
            -20,
            3300000
          ],
          "gsd": 20,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Scene classfication map (SCL)"
        },
        "WVP": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/WVP.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            10980,
            10980
          ],
          "proj:transform": [
            10,
            0,
            300000,
            0,
            -10,
            3300000
          ],
          "gsd": 10,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "Water vapour (WVP)"
        },
        "visual": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/visual.tif",
          "proj:bbox": [
            300000,
            3190200,
            409800,
            3300000
          ],
          "proj:shape": [
            10980,
            10980
          ],
          "proj:transform": [
            10,
            0,
            300000,
            0,
            -10,
            3300000
          ],
          "gsd": 10,
          "type": "image/tiff; application=geotiff; profile=cloud-optimized",
          "roles": [
            "data"
          ],
          "title": "True color image",
          "eo:bands": [
            {
              "name": "B04",
              "common_name": "red",
              "description": "Band 4 - Red",
              "center_wavelength": 0.665,
              "full_width_half_max": 0.038
            },
            {
              "name": "B03",
              "common_name": "green",
              "description": "Band 3 - Green",
              "center_wavelength": 0.56,
              "full_width_half_max": 0.045
            },
            {
              "name": "B02",
              "common_name": "blue",
              "description": "Band 2 - Blue",
              "center_wavelength": 0.49,
              "full_width_half_max": 0.098
            }
          ]
        },
        "safe-manifest": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/safe-manifest.safe",
          "type": "application/xml",
          "roles": [
            "metadata"
          ],
          "title": "SAFE manifest"
        },
        "granule-metadata": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/granule-metadata.xml",
          "type": "application/xml",
          "roles": [
            "metadata"
          ],
          "title": "Granule metadata"
        },
        "inspire-metadata": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/inspire-metadata.xml",
          "type": "application/xml",
          "roles": [
            "metadata"
          ],
          "title": "INSPIRE metadata"
        },
        "product-metadata": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/product-metadata.xml",
          "type": "application/xml",
          "roles": [
            "metadata"
          ],
          "title": "Product metadata"
        },
        "datastrip-metadata": {
          "href": "https://ysuxzldatasa.blob.core.windows.net/sentinel-2-l2a-test-collection-0101d529594b-a7a94b80/bdd/S2A_MSIL2A_20240211T163421_R083_T16RCT_20240211T222120/datastrip-metadata.xml",
          "type": "application/xml",
          "roles": [
            "metadata"
          ],
          "title": "Datastrip metadata"
        }
      },
      "_msft:ts": "2024-11-06T22:48:32.746991Z",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -89.0695901,
              29.8142551
            ],
            [
              -87.9335875,
              29.8271684
            ],
            [
              -87.924604,
              28.8362971
            ],
            [
              -89.0496889,
              28.8238937
            ],
            [
              -89.0695901,
              29.8142551
            ]
          ]
        ]
      },
      "_msft:etag": "0faf1c9f-3a1f-4d69-8beb-cc89bec0f76a",
      "collection": "sentinel-2-l2a-test-collection-0101d529594b",
      "properties": {
        "datetime": "2024-02-11T16:34:21.024000Z",
        "platform": "Sentinel-2A",
        "proj:epsg": 32616,
        "instruments": [
          "msi"
        ],
        "s2:mgrs_tile": "16RCT",
        "constellation": "Sentinel 2",
        "s2:granule_id": "S2A_OPER_MSI_L2A_TL_MSFT_20240211T222120_A045125_T16RCT_N05.10",
        "eo:cloud_cover": 100,
        "s2:datatake_id": "GS2A_20240211T163421_045125_N05.10",
        "s2:product_uri": "S2A_MSIL2A_20240211T163421_N0510_R083_T16RCT_20240211T222120.SAFE",
        "s2:datastrip_id": "S2A_OPER_MSI_L2A_DS_MSFT_20240211T222120_S20240211T164431_N05.10",
        "s2:product_type": "S2MSI2A",
        "sat:orbit_state": "descending",
        "s2:datatake_type": "INS-RAW",
        "s2:generation_time": "2024-02-11T22:21:20.341595Z",
        "sat:relative_orbit": 83,
        "s2:water_percentage": 0,
        "s2:mean_solar_zenith": 47.739082267841,
        "s2:mean_solar_azimuth": 152.402799769714,
        "s2:processing_baseline": "05.10",
        "s2:snow_ice_percentage": 0,
        "s2:vegetation_percentage": 0,
        "s2:thin_cirrus_percentage": 0.930425,
        "s2:cloud_shadow_percentage": 0,
        "s2:nodata_pixel_percentage": 0,
        "s2:unclassified_percentage": 0,
        "s2:dark_features_percentage": 0,
        "s2:not_vegetated_percentage": 0,
        "s2:degraded_msi_data_percentage": 0.0189,
        "s2:high_proba_clouds_percentage": 46.895468,
        "s2:reflectance_conversion_factor": 1.02819912068379,
        "s2:medium_proba_clouds_percentage": 52.174109,
        "s2:saturated_defective_pixel_percentage": 0
      },
      "stac_extensions": [
        "https://stac-extensions.github.io/eo/v1.1.0/schema.json",
        "https://stac-extensions.github.io/sat/v1.0.0/schema.json",
        "https://stac-extensions.github.io/projection/v1.1.0/schema.json"
      ],
      "stac_version": "1.0.0"
    }
  ]
}

Statuscode:: 204

Definitionen

Name	Beschreibung
Asset	https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#asset-object Stellt ein STAC-Objekt dar, bei dem es sich um eine Datei oder Ressource handelt, die bzw. die einem STAC-Element zugeordnet ist.
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Microsoft One-API-Richtlinien – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
ContextExtension	https://github.com/radiantearth/stac-api-spec/tree/master/extensions/context#context-extension-specification Kontextinformationen für eine Suchantwort, einschließlich Paginierungsdetails.
FeatureType	Typbezeichner für GeoJSON-Feature-Objekte
FilterLang	Optionen für den filter-lang-Wert in einer POST-Anforderung. Basierend auf https://github.com/stac-api-extensions/filter#queryables Beachten Sie die Hinzufügung von cql2-json, das vom pgstac-Backend verwendet wird, aber nicht in der obigen Spezifikation enthalten ist. Definiert die unterstützten Filtersprachen für STAC-API-Abfragen.
ItemCollection	https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/itemcollection-spec.md Stellt eine Auflistung von STAC-Elementen als GeoJSON FeatureCollection dar.
ItemCollectionType	Stellt den GeoJSON-Featuresammlungstyp für STAC-Elementsammlungen dar.
ItemProperties	Eigenschaften eines STAC-Elements, das Metadaten über das Asset enthält. https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#properties-object
Link	Link-Modell. Referenz: http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml Stellt einen Link dar.
LinkType	MIME-Typen für Links.
Provider	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#provider-object Stellt Informationen zu einem Datenanbieter für STAC-Sammlungen und -Elemente dar.
SearchPostRequest	Modell suchen. Überschreibt die Validierung für datetime aus dem Basisanforderungsmodell. Definiert Parameter für eine POST-Anforderung für die STAC-Suche.
SearchPostRequestFields	FieldsExtension verwenden. Attribute: include: Satz von Feldern, die eingeschlossen werden sollen. exclude: Satz von Feldern, die ausgeschlossen werden sollen. Steuert, welche Felder in die Antwort ein- oder ausgeschlossen werden sollen.
SignType	Stellen Sie den Signaturtyp für Asset-URLs dar.
SortDirections	Definiert die Sortierrichtungen für Abfrageergebnisse in der STAC-API.
SortExtension	https://github.com/radiantearth/stac-api-spec/tree/master/extensions/sort#sort-api-extension Stellt eine Sortierspezifikation für STAC-API-Abfragen dar.
StacItem	Stellt ein STAC-Element dar, bei dem es sich um ein GeoJSON-Feature mit zusätzlichen Metadaten handelt.

Asset

Objekt

https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#asset-object

Stellt ein STAC-Objekt dar, bei dem es sich um eine Datei oder Ressource handelt, die bzw. die einem STAC-Element zugeordnet ist.

Name	Typ	Beschreibung
constellation	string	Konstellation von Satelliten, die die Daten erfasst haben.
created	string (date-time)	Zeitstempel der Erstellung der Daten.
description	string	Detaillierte Beschreibung des Vermögenswerts.
gsd	number (float)	Entfernung der Bodenprobe in Metern.
href	string minLength: 1	URL zur Asset-Datei.
instruments	string[]	Instrumente, die die Daten erfasst haben.
mission	string	Mission, die mit den Daten verknüpft ist.
platform	string	Plattform, die die Daten erfasst hat.
providers	Provider[]	Organisationen oder Einzelpersonen, die die Daten bereitstellen.
roles	string[]	Rollen des Assets innerhalb des Artikels.
title	string	Lesbarer Titel für das Asset.
type	string	Medientyp der Ressource.
updated	string (date-time)	Zeitstempel der letzten Aktualisierung der Daten.

Azure.Core.Foundations.Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine normal lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Microsoft One-API-Richtlinien – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

ContextExtension

Objekt

https://github.com/radiantearth/stac-api-spec/tree/master/extensions/context#context-extension-specification

Kontextinformationen für eine Suchantwort, einschließlich Paginierungsdetails.

Name	Typ	Beschreibung
limit	integer (int32)	Maximale Anzahl der angeforderten Artikel.
matched	integer (int32)	Gesamtanzahl der Elemente, die der Abfrage entsprechen.
returned	integer (int32)	Anzahl der Elemente, die in der Antwort zurückgegeben werden.

FeatureType

Enumeration

Typbezeichner für GeoJSON-Feature-Objekte

Wert	Beschreibung
Feature	Standardmäßiger GeoJSON-Featuretypbezeichner

FilterLang

Enumeration

Optionen für den filter-lang-Wert in einer POST-Anforderung.

Basierend auf https://github.com/stac-api-extensions/filter#queryables

Beachten Sie die Hinzufügung von cql2-json, das vom pgstac-Backend verwendet wird, aber nicht in der obigen Spezifikation enthalten ist.

Definiert die unterstützten Filtersprachen für STAC-API-Abfragen.

Wert	Beschreibung
cql-json	Allgemeine Abfragesprache im JSON-Format.
cql2-json	Common Query Language 2 im JSON-Format
cql2-text	Common Query Language 2 im Textformat.

ItemCollection

Objekt

https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/itemcollection-spec.md

Stellt eine Auflistung von STAC-Elementen als GeoJSON FeatureCollection dar.

Name	Typ	Standardwert	Beschreibung
bbox	number[] (double)		Begrenzungsrahmen aller Elemente im Format [West, Süd, Ost, Nord].
context	ContextExtension		Kontextinformationen für die Suchantwort.
features	StacItem[]		Array von STAC-Elementen in der Sammlung.
links	Link[]		Links zu verwandten Ressourcen und Endpunkten.
msft:_created	string		MSFT erstellt
msft:_updated	string		MSFT Aktualisiert
msft:short_description	string maxLength: 300		MSFT Kurzbeschreibung
stac_extensions	string[]		URLs zu STAC-Erweiterungen, die von dieser STAC-Ressource implementiert werden.
stac_version	string minLength: 1	1.0.0	Stac-Version
type	ItemCollectionType		GeoJSON FeatureCollection-Typ.

ItemCollectionType

Enumeration

Stellt den GeoJSON-Featuresammlungstyp für STAC-Elementsammlungen dar.

Wert	Beschreibung
FeatureCollection	Standardmäßiger GeoJSON-FeatureCollection-Typ.

ItemProperties

Objekt

Eigenschaften eines STAC-Elements, das Metadaten über das Asset enthält.

https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#properties-object

Name	Typ	Beschreibung
constellation	string	Konstellation von Satelliten, die die Daten erfasst haben.
created	string (date-time)	Zeitstempel der Erstellung der Daten.
datetime	string	Datetime, die das Asset im RFC 3339-Format darstellt.
description	string	Detaillierte Beschreibung des Artikels.
end_datetime	string (date-time)	Endzeit des Beobachtungszeitraums des Elements.
gsd	number (float)	Entfernung der Bodenprobe in Metern.
instruments	string[]	Instrumente, die die Daten erfasst haben.
mission	string	Mission, die mit den Daten verknüpft ist.
platform	string	Plattform, die die Daten erfasst hat.
providers	Provider[]	Organisationen oder Einzelpersonen, die die Daten bereitstellen.
start_datetime	string (date-time)	Startzeit des Beobachtungszeitraums des Items.
title	string	Lesbarer Titel für das Element.
updated	string (date-time)	Zeitstempel der letzten Aktualisierung der Daten.

Link

Objekt

Link-Modell.

Referenz: http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml

Stellt einen Link dar.

Name	Typ	Standardwert	Beschreibung
body	object		Bei POST-Anforderungen kann die Ressource den HTTP-Text als JSON-Objekt angeben.
headers	object		Objekt-Schlüssel-Wert-Paare, die Headern zugeordnet sind. Beispiel: { "Akzeptieren": "Anwendung/json" }.
href	string		Die URL des Links.
hreflang	string		Die Sprache der verknüpften Ressource.
length	integer (int32)		Die Länge der verknüpften Ressource.
merge	boolean	False	Gibt an, ob vom Client erwartet wird, dass er den body-Wert mit dem aktuellen Anforderungstext zusammenführt, bevor er dem Link folgt. Dies ist nur gültig, wenn der Server auf eine POST-Anforderung antwortet. Standardwert: false.
method	enum: GET POST	GET	Gibt die HTTP-Methode an, die von der Ressource erwartet wird. Standardwert: GET.
rel	string		Der Beziehungstyp der Verknüpfung.
title	string		Der Titel des Links.
type	LinkType	application/json	Der MIME-Typ der verknüpften Ressource.

LinkType

Enumeration

MIME-Typen für Links.

Wert	Beschreibung
application/geo+json	Stellt eine application/geo+json dar.
application/json	Stellt eine application/json dar.
application/x-binary	Stellt eine application/x-binär dar.
application/x-protobuf	Stellt eine Anwendung/ein x-protobuf dar.
application/xml	Stellt eine Anwendung/XML dar.
image/jp2	Stellt ein image/jp2 dar.
image/jpeg	Stellt ein Bild/JPEG dar.
image/jpg	Stellt ein Bild/jpg dar.
image/png	Stellt ein Bild/PNG dar.
image/tiff; application=geotiff	Stellt ein Bild/TIFF mit application=geotiff dar.
image/webp	Stellt ein Bild/Webp dar.
text/html	Stellt einen Text/HTML dar.
text/plain	Stellt einen Text/eine einfache Datei dar.

Provider

Objekt

https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#provider-object

Stellt Informationen zu einem Datenanbieter für STAC-Sammlungen und -Elemente dar.

Name	Typ	Beschreibung
description	string	Beschreibung des Anbieters.
name	string minLength: 1	Name des Anbieters, der Organisation oder der Person.
roles	string[]	Rollen, die der Anbieter spielt (z. B. Produzent, Auftragsverarbeiter, Host).
url	string	URL zur Website des Anbieters.

SearchPostRequest

Objekt

Modell suchen.

Überschreibt die Validierung für datetime aus dem Basisanforderungsmodell.

Definiert Parameter für eine POST-Anforderung für die STAC-Suche.

Name	Typ	Standardwert	Beschreibung
bbox	number[] (double)		Begrenzungsrahmen für die räumliche Filterung im Format [West, Süd, Ost, Nord].
collections	string[]		Liste der Sammlungs-IDs, in denen gesucht werden soll.
conf	object		Conf
datetime	string		Der zeitliche Filter im RFC 3339-Format kann eine einzelne Zeit oder ein Bereich sein.
duration	integer (int32)		Dauer der URL-Signatur in Sekunden.
fields	SearchPostRequestFields[]		https://github.com/stac-api-extensions/fields Gibt an, welche Felder in die Antwort ein- oder ausgeschlossen werden sollen.
filter	object		https://github.com/stac-api-extensions/filter Filter
filter-crs	string		Koordinatenreferenzsystem für den Filter.
filter-lang	FilterLang	cql-json	Filtersprache, die für den Filterausdruck verwendet werden soll.
ids	string[]		Liste der spezifischen Element-IDs, die zurückgegeben werden sollen.
intersects	GeoJson		GeoJSON-Geometrie für die räumliche Filterung.
limit	integer (int32) minimum: 1 maximum: 1000	250	Maximale Anzahl der zurückzugebenden Ergebnisse.
query	object		https://github.com/stac-api-extensions/query Abfrage
sign	SignType		Gibt an, ob Asset-URLs in der Antwort signiert werden sollen.
sortby	SortExtension[]		https://github.com/stac-api-extensions/sort Sortierkriterien für die Suchergebnisse.
token	string		Paginierungstoken zum Abrufen des nächsten Satzes von Ergebnissen.

SearchPostRequestFields

Objekt

FieldsExtension verwenden.

Attribute: include: Satz von Feldern, die eingeschlossen werden sollen. exclude: Satz von Feldern, die ausgeschlossen werden sollen.

Steuert, welche Felder in die Antwort ein- oder ausgeschlossen werden sollen.

Name	Typ	Beschreibung
exclude	string[]	Array von Feldnamen, die aus der Antwort ausgeschlossen werden sollen.
include	string[]	Array von Feldnamen, die in die Antwort aufgenommen werden sollen.

SignType

Enumeration

Stellen Sie den Signaturtyp für Asset-URLs dar.

Wert	Beschreibung
false	Signieren Sie keine Asset-URLs in der Antwort.
true	Signieren Sie Asset-URLs in der Antwort.

SortDirections

Enumeration

Definiert die Sortierrichtungen für Abfrageergebnisse in der STAC-API.

Wert	Beschreibung
asc	Sortieren Sie die Ergebnisse in aufsteigender Reihenfolge.
desc	Sortieren Sie die Ergebnisse in absteigender Reihenfolge.

SortExtension

Objekt

https://github.com/radiantearth/stac-api-spec/tree/master/extensions/sort#sort-api-extension

Stellt eine Sortierspezifikation für STAC-API-Abfragen dar.

Name	Typ	Beschreibung
direction	SortDirections	Die Sortierrichtung (aufsteigend oder absteigend).
field	string minLength: 1	Der Feldname, nach dem sortiert werden soll.

StacItem

Objekt

Stellt ein STAC-Element dar, bei dem es sich um ein GeoJSON-Feature mit zusätzlichen Metadaten handelt.

Name	Typ	Standardwert	Beschreibung
_msft:etag	string		MSFT ETag
_msft:ts	string		MSFT-Zeitstempel
assets	<string, Asset>		Vermögenswerte
bbox	number[] (double)		Koordinaten des Begrenzungsrahmens für das Feature
collection	string		ID der STAC-Sammlung, zu der dieser Artikel gehört.
geometry	GeoJson		Geometrieobjekt, das die Form des Features definiert
id	string		Eindeutige Kennung für das Feature
links	Link[]		Links zu verwandten Ressourcen und Endpunkten.
msft:_created	string		MSFT erstellt
msft:_updated	string		MSFT Aktualisiert
msft:short_description	string maxLength: 300		MSFT Kurzbeschreibung
properties	ItemProperties		Attribute, die mit dem Feature verknüpft sind
stac_extensions	string[]		URLs zu STAC-Erweiterungen, die von dieser STAC-Ressource implementiert werden.
stac_version	string minLength: 1	1.0.0	Stac-Version
type	FeatureType		GeoJSON-Typbezeichner für Feature

Freigeben über

Stac Search Operations - Create

URI-Parameter

Anforderungstext

Antworten

Sicherheit

OAuth2Auth

Bereiche

Beispiele

StacSearchOperations_Create

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Asset

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

ContextExtension

FeatureType

FilterLang

ItemCollection

ItemCollectionType

ItemProperties

Link

LinkType

Provider

SearchPostRequest

SearchPostRequestFields

SignType

SortDirections

SortExtension

StacItem