Stac Search Operations - Create

Référence

Service:: Planetary Computer

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

Rechercher
Point de terminaison.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
bbox	number[] (double)	Boîte englobante pour le filtrage spatial au format [ouest, sud, est, nord].
collections	string[]	Liste des ID de collection dans lesquels effectuer des recherches.
conf	object	Conf
datetime	string	Le filtre temporel au format RFC 3339 peut être un seul temps ou une plage.
duration	integer (int32)	Durée de la signature de l’URL en secondes.
fields	SearchPostRequestFields[]	https://github.com/stac-api-extensions/fields Spécifie les champs à inclure ou à exclure dans la réponse.
filter	object	https://github.com/stac-api-extensions/filter Filtre
filter-crs	string	Système de coordonnées de référence pour le filtre.
filter-lang	FilterLang	Langue de filtre à utiliser pour l’expression de filtre.
ids	string[]	Liste des ID d’élément spécifiques à renvoyer.
intersects	GeoJson	Géométrie GeoJSON pour le filtrage spatial.
limit	integer (int32) minimum: 1 maximum: 1000	Nombre maximal de résultats à retourner.
query	object	https://github.com/stac-api-extensions/query Requête
sign	SignType	Indique s’il faut signer les URL des ressources dans la réponse.
sortby	SortExtension[]	https://github.com/stac-api-extensions/sort Critères de tri pour les résultats de recherche.
token	string	Jeton de pagination pour récupérer l’ensemble suivant de résultats.

Réponses

Nom	Type	Description
200 OK	ItemCollection	La demande a réussi.
204 No Content		Il n’existe aucun contenu à envoyer pour cette demande, mais les en-têtes peuvent être utiles.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Nom

Type

Description

200 OK

ItemCollection

La demande a réussi.

204 No Content

Il n’existe aucun contenu à envoyer pour cette demande, mais les en-têtes peuvent être utiles.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Réponse d’erreur inattendue.

En-têtes

x-ms-error-code: string

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
https://geocatalog.spatio.azure.com/.default

Exemples

StacSearchOperations_Create

Exemple de requête

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"
  ]
}

Exemple de réponse

Code d’état:: 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"
    }
  ]
}

Code d’état:: 204

Définitions

Nom	Description
Asset	https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#asset-object Représente un actif STAC, c’est-à-dire un fichier ou une ressource associé à un élément STAC.
Azure.Core.Foundations.Error	Objet d’erreur.
Azure.Core.Foundations.ErrorResponse	Réponse contenant les détails de l’erreur.
Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - 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 Informations contextuelles pour une réponse de recherche, y compris les détails de pagination.
FeatureType	Identificateur de type pour les objets GeoJSON Feature
FilterLang	Choix de la valeur filter-lang dans une requête POST. Basé sur https://github.com/stac-api-extensions/filter#queryables Notez l’ajout de cql2-json, qui est utilisé par le backend pgstac, mais n’est pas inclus dans la spécification ci-dessus. Définit les langues de filtre prises en charge pour les requêtes d’API STAC.
ItemCollection	https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/itemcollection-spec.md Représente une collection d’éléments STAC sous la forme d’une GeoJSON FeatureCollection.
ItemCollectionType	Représente le type de collection d’entités GeoJSON pour les collections d’éléments STAC.
ItemProperties	Propriétés d’un élément STAC contenant des métadonnées sur la ressource. https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#properties-object
Link	Modèle de lien. Ref : http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml Représente un lien.
LinkType	Types MIME pour les liens.
Provider	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#provider-object Représente des informations sur un fournisseur de données pour les collections et les éléments STAC.
SearchPostRequest	Modèle de recherche. Remplace la validation de datetime à partir du modèle de demande de base. Définit les paramètres d’une requête POST de recherche STAC.
SearchPostRequestFields	ChampsExtension. Attributs : include : ensemble de champs à inclure. exclude : ensemble des champs à exclure. Contrôle les champs à inclure ou à exclure de la réponse.
SignType	Représente le type de signature pour les URL de ressources.
SortDirections	Définit les directions de tri pour les résultats de requête dans l’API STAC.
SortExtension	https://github.com/radiantearth/stac-api-spec/tree/master/extensions/sort#sort-api-extension Représente une spécification de tri pour les requêtes d’API STAC.
StacItem	Représente un élément STAC, qui est une fonctionnalité GeoJSON avec des métadonnées supplémentaires.

Asset

Object

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

Représente un actif STAC, c’est-à-dire un fichier ou une ressource associé à un élément STAC.

Nom	Type	Description
constellation	string	Constellation de satellites qui ont acquis les données.
created	string (date-time)	Horodatage de création des données.
description	string	Description détaillée de l’actif.
gsd	number (float)	Distance de l’échantillon au sol en mètres.
href	string minLength: 1	URL du fichier de ressources.
instruments	string[]	Instruments qui ont acquis les données.
mission	string	Mission associée aux données.
platform	string	Plateforme qui a acquis les données.
providers	Provider[]	Les organisations ou les individus qui fournissent les données.
roles	string[]	Rôles de l’actif au sein de l’élément.
title	string	Titre lisible par l’homme pour la ressource.
type	string	Type de média de la ressource.
updated	string (date-time)	Horodatage de la dernière mise à jour des données.

Azure.Core.Foundations.Error

Object

Objet d’erreur.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
details	Azure.Core.Foundations.Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Une représentation lisible par une personne de l'erreur.
target	string	Cible de l’erreur.

Azure.Core.Foundations.ErrorResponse

Object

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	Azure.Core.Foundations.Error	Objet d’erreur.

Azure.Core.Foundations.InnerError

Object

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
innererror	Azure.Core.Foundations.InnerError	Erreur interne.

ContextExtension

Object

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

Informations contextuelles pour une réponse de recherche, y compris les détails de pagination.

Nom	Type	Description
limit	integer (int32)	Nombre maximum d’articles demandés.
matched	integer (int32)	Nombre total d’éléments correspondant à la requête.
returned	integer (int32)	Nombre d’éléments renvoyés dans la réponse.

FeatureType

Énumération

Identificateur de type pour les objets GeoJSON Feature

Valeur	Description
Feature	Identificateur de type d’entité GeoJSON standard

FilterLang

Énumération

Choix de la valeur filter-lang dans une requête POST.

Basé sur https://github.com/stac-api-extensions/filter#queryables

Notez l’ajout de cql2-json, qui est utilisé par le backend pgstac, mais n’est pas inclus dans la spécification ci-dessus.

Définit les langues de filtre prises en charge pour les requêtes d’API STAC.

Valeur	Description
cql-json	Langage de requête commun au format JSON.
cql2-json	Common Query Language 2 au format JSON
cql2-text	Common Query Language 2 au format texte.

ItemCollection

Object

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

Représente une collection d’éléments STAC sous la forme d’une GeoJSON FeatureCollection.

Nom	Type	Valeur par défaut	Description
bbox	number[] (double)		Boîte englobante de tous les éléments au format [ouest, sud, est, nord].
context	ContextExtension		Informations contextuelles pour la réponse de recherche.
features	StacItem[]		Ensemble d’articles STAC dans la collection.
links	Link[]		Liens vers des ressources et des points de terminaison connexes.
msft:_created	string		Création de MSFT
msft:_updated	string		MSFT mis à jour
msft:short_description	string maxLength: 300		MSFT Brève description
stac_extensions	string[]		URL vers les extensions STAC implémentées par cette ressource STAC.
stac_version	string minLength: 1	1.0.0	Stac Version
type	ItemCollectionType		GeoJSON FeatureType de collection.

ItemCollectionType

Énumération

Représente le type de collection d’entités GeoJSON pour les collections d’éléments STAC.

Valeur	Description
FeatureCollection	Type de collection GeoJSON FeatureStandard.

ItemProperties

Object

Propriétés d’un élément STAC contenant des métadonnées sur la ressource.

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

Nom	Type	Description
constellation	string	Constellation de satellites qui ont acquis les données.
created	string (date-time)	Horodatage de création des données.
datetime	string	Datetime que la ressource représente au format RFC 3339.
description	string	Description détaillée de l’article.
end_datetime	string (date-time)	Heure de fin de la période d’observation de l’article.
gsd	number (float)	Distance de l’échantillon au sol en mètres.
instruments	string[]	Instruments qui ont acquis les données.
mission	string	Mission associée aux données.
platform	string	Plateforme qui a acquis les données.
providers	Provider[]	Les organisations ou les individus qui fournissent les données.
start_datetime	string (date-time)	Heure de début de la période d’observation de l’article.
title	string	Titre lisible par l’homme pour l’élément.
updated	string (date-time)	Horodatage de la dernière mise à jour des données.

Link

Object

Modèle de lien.

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

Représente un lien.

Nom	Type	Valeur par défaut	Description
body	object		Pour les requêtes POST, la ressource peut spécifier le corps HTTP en tant qu’objet JSON.
headers	object		Paires clé-valeur d’objet mappées aux en-têtes. Exemple : { « Accept » : « application/json » }.
href	string		URL du lien.
hreflang	string		Langue de la ressource liée.
length	integer (int32)		Longueur de la ressource liée.
merge	boolean	False	Indique si le client doit fusionner la valeur body dans le corps de la requête actuelle avant de suivre le lien. Cette option n’est valable que lorsque le serveur répond à une requête POST. Valeur par défaut : false.
method	enum: GET POST	GET	Spécifie la méthode HTTP attendue par la ressource. Par défaut : GET.
rel	string		Type de relation du lien.
title	string		Le titre du lien.
type	LinkType	application/json	Type MIME de la ressource liée.

LinkType

Énumération

Types MIME pour les liens.

Valeur	Description
application/geo+json	Représente une application/geo+json.
application/json	Représente une application/json.
application/x-binary	Représente une application/x-binaire.
application/x-protobuf	Représente une application/x-protobuf.
application/xml	Représente une application/xml.
image/jp2	Représente une image/jp2.
image/jpeg	Représente une image/jpeg.
image/jpg	Représente une image/jpg.
image/png	Représente une image/png.
image/tiff; application=geotiff	Représente une image/tiff avec application=geotiff.
image/webp	Représente une image/webp.
text/html	Représente un texte/html.
text/plain	Représente un texte/simple.

Provider

Object

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

Représente des informations sur un fournisseur de données pour les collections et les éléments STAC.

Nom	Type	Description
description	string	Description du prestataire.
name	string minLength: 1	Nom de l’organisation ou de la personne du fournisseur.
roles	string[]	Rôles joués par le fournisseur (p. ex., producteur, transformateur, hôte).
url	string	URL du site Web du fournisseur.

SearchPostRequest

Object

Modèle de recherche.

Remplace la validation de datetime à partir du modèle de demande de base.

Définit les paramètres d’une requête POST de recherche STAC.

Nom	Type	Valeur par défaut	Description
bbox	number[] (double)		Boîte englobante pour le filtrage spatial au format [ouest, sud, est, nord].
collections	string[]		Liste des ID de collection dans lesquels effectuer des recherches.
conf	object		Conf
datetime	string		Le filtre temporel au format RFC 3339 peut être un seul temps ou une plage.
duration	integer (int32)		Durée de la signature de l’URL en secondes.
fields	SearchPostRequestFields[]		https://github.com/stac-api-extensions/fields Spécifie les champs à inclure ou à exclure dans la réponse.
filter	object		https://github.com/stac-api-extensions/filter Filtre
filter-crs	string		Système de coordonnées de référence pour le filtre.
filter-lang	FilterLang	cql-json	Langue de filtre à utiliser pour l’expression de filtre.
ids	string[]		Liste des ID d’élément spécifiques à renvoyer.
intersects	GeoJson		Géométrie GeoJSON pour le filtrage spatial.
limit	integer (int32) minimum: 1 maximum: 1000	250	Nombre maximal de résultats à retourner.
query	object		https://github.com/stac-api-extensions/query Requête
sign	SignType		Indique s’il faut signer les URL des ressources dans la réponse.
sortby	SortExtension[]		https://github.com/stac-api-extensions/sort Critères de tri pour les résultats de recherche.
token	string		Jeton de pagination pour récupérer l’ensemble suivant de résultats.

SearchPostRequestFields

Object

ChampsExtension.

Attributs : include : ensemble de champs à inclure. exclude : ensemble des champs à exclure.

Contrôle les champs à inclure ou à exclure de la réponse.

Nom	Type	Description
exclude	string[]	Tableau de noms de champs à exclure de la réponse.
include	string[]	Tableau de noms de champs à inclure dans la réponse.

SignType

Énumération

Représente le type de signature pour les URL de ressources.

Valeur	Description
false	Ne signez pas d’URL de ressource dans la réponse.
true	Signez les URL des ressources dans la réponse.

SortDirections

Énumération

Définit les directions de tri pour les résultats de requête dans l’API STAC.

Valeur	Description
asc	Le tri donne les résultats dans l’ordre croissant.
desc	Le tri donne les résultats par ordre décroissant.

SortExtension

Object

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

Représente une spécification de tri pour les requêtes d’API STAC.

Nom	Type	Description
direction	SortDirections	Le sens de tri (croissant ou décroissant).
field	string minLength: 1	Nom du champ à trier.

StacItem

Object

Représente un élément STAC, qui est une fonctionnalité GeoJSON avec des métadonnées supplémentaires.

Nom	Type	Valeur par défaut	Description
_msft:etag	string		MSFT ETag
_msft:ts	string		Horodatage MSFT
assets	<string, Asset>		Actifs
bbox	number[] (double)		Coordonnées du cadre de délimitation de la fonction
collection	string		ID de la collection STAC à laquelle cet article appartient.
geometry	GeoJson		Objet géométrique définissant la forme de l’entité
id	string		Identificateur unique de la fonctionnalité
links	Link[]		Liens vers des ressources et des points de terminaison connexes.
msft:_created	string		Création de MSFT
msft:_updated	string		MSFT mis à jour
msft:short_description	string maxLength: 300		MSFT Brève description
properties	ItemProperties		Attributs associés à la fonctionnalité
stac_extensions	string[]		URL vers les extensions STAC implémentées par cette ressource STAC.
stac_version	string minLength: 1	1.0.0	Stac Version
type	FeatureType		Identificateur de type GeoJSON pour l’entité

Partager via

Stac Search Operations - Create

Paramètres URI

Corps de la demande

Réponses

Sécurité

OAuth2Auth

Étendues

Exemples

StacSearchOperations_Create

Exemple de requête

Exemple de réponse

Définitions

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