Stac Landing Pages - Get

Referencia

Szolgáltatás:: Planetary Computer

API-verzió:: 2025-04-30-preview

Nyitóoldal
Végpont.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Válaszok

Name	Típus	Description
200 OK	LandingPage	A kérés sikeres volt.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Name

Típus

Description

200 OK

LandingPage

A kérés sikeres volt.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Példák

StacLandingPages_Get

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 200

{
  "type": "Catalog",
  "id": "spatio-stac",
  "title": "Azure Spatio (Preview/Confidential)",
  "description": "Azure Spatio (Preview/Confidential) STAC API",
  "stac_version": "1.0.0",
  "conformsTo": [
    "http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2",
    "http://www.opengis.net/spec/cql2/1.0/conf/cql2-json",
    "http://www.opengis.net/spec/cql2/1.0/conf/cql2-text",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson",
    "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30",
    "http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter",
    "https://api.stacspec.org/v1.0.0-rc.2/item-search#filter",
    "https://api.stacspec.org/v1.0.0/collections",
    "https://api.stacspec.org/v1.0.0/core",
    "https://api.stacspec.org/v1.0.0/item-search",
    "https://api.stacspec.org/v1.0.0/item-search#fields",
    "https://api.stacspec.org/v1.0.0/item-search#query",
    "https://api.stacspec.org/v1.0.0/item-search#sort",
    "https://api.stacspec.org/v1.0.0/ogcapi-features"
  ],
  "links": [
    {
      "rel": "self",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/"
    },
    {
      "rel": "root",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/"
    },
    {
      "rel": "data",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/collections"
    },
    {
      "rel": "conformance",
      "type": "application/json",
      "title": "STAC/OGC conformance classes implemented by this server",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/conformance"
    },
    {
      "rel": "search",
      "type": "application/geo+json",
      "title": "STAC search",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/search",
      "method": "GET"
    },
    {
      "rel": "search",
      "type": "application/geo+json",
      "title": "STAC search",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/search",
      "method": "POST"
    },
    {
      "rel": "http://www.opengis.net/def/rel/ogc/1.0/queryables",
      "type": "application/schema+json",
      "title": "Queryables",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/queryables",
      "method": "GET"
    },
    {
      "rel": "child",
      "type": "application/json",
      "title": "Example Collection",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/collections/example-collection"
    },
    {
      "rel": "child",
      "type": "application/json",
      "title": "sentinel-2-l2a-test-collection-0101d529594b",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/api/collections/sentinel-2-l2a-test-collection-0101d529594b"
    },
    {
      "rel": "service-desc",
      "type": "application/vnd.oai.openapi+json;version=3.0",
      "title": "OpenAPI service description",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/openapi.json"
    },
    {
      "rel": "service-doc",
      "type": "text/html",
      "title": "OpenAPI service documentation",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/docs"
    }
  ],
  "stac_extensions": []
}

Definíciók

Name	Description
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Microsoft One API irányelvei szerint – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
LandingPage	https://github.com/radiantearth/stac-api-spec/blob/master/api-spec.md#ogc-api---features-endpoints A STAC API kezdőlapját jelöli az elérhető erőforrásokra mutató hivatkozásokkal.
Link	Hivatkozás modell. Ref: http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml Egy hivatkozást jelöl.
LinkType	MIME-típusok a hivatkozásokhoz.

Azure.Core.Foundations.Error

Objektum

A hibaobjektum.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Objektum

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Objektum

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Microsoft One API irányelvei szerint – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

LandingPage

Objektum

https://github.com/radiantearth/stac-api-spec/blob/master/api-spec.md#ogc-api---features-endpoints

A STAC API kezdőlapját jelöli az elérhető erőforrásokra mutató hivatkozásokkal.

Name	Típus	Alapértelmezett érték	Description
conformsTo	string[] (uri)		Az API által megvalósított OGC API megfelelőségi osztályok listája.
description	string minLength: 1		A STAC katalógus részletes leírása.
id	string minLength: 1		A STAC katalógus egyedi azonosítója.
links	Link[]		Kapcsolódó erőforrásokra és végpontokra mutató hivatkozások.
msft:_created	string		MSFT létrehozva
msft:_updated	string		MSFT frissítve
msft:short_description	string maxLength: 300		MSFT rövid leírás
stac_extensions	string[]		A STAC-erőforrás által megvalósított STAC-bővítmények URL-címei.
stac_version	string	1.0.0	Stac verzió
title	string		A STAC katalógus ember által olvasható címe.
type	string minLength: 1	Catalog	típus

Link

Objektum

Hivatkozás modell.

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

Egy hivatkozást jelöl.

Name	Típus	Alapértelmezett érték	Description
body	object		POST-kérések esetén az erőforrás JSON-objektumként adhatja meg a HTTP-törzset.
headers	object		Fejlécekre leképezett objektumkulcs-érték párok. Példa: { "Accept": "application/json" }.
href	string		A hivatkozás URL-címe.
hreflang	string		A csatolt erőforrás nyelve.
length	integer (int32)		A csatolt erőforrás hossza.
merge	boolean	False	Azt jelzi, hogy az ügyfélnek a hivatkozás követése előtt egyesítenie kell-e a törzs értékét az aktuális kérelem törzsével. Ez csak akkor érvényes, ha a kiszolgáló POST-kérésre válaszol. Alapértelmezett: hamis.
method	enum: GET POST	GET	Megadja az erőforrás által várt HTTP-metódust. Alapértelmezett: GET.
rel	string		A kapcsolat kapcsolattípusa.
title	string		A link címe.
type	LinkType	application/json	A csatolt erőforrás MIME-típusa.

LinkType

Enumerálás

MIME-típusok a hivatkozásokhoz.

Érték	Description
application/geo+json	Egy application/geo+json alkalmazást jelöl.
application/json	Egy alkalmazást/json jelöl.
application/x-binary	Egy alkalmazást/x-bináris fájlt jelöl.
application/x-protobuf	Egy application/x-protobuf elemet jelöl.
application/xml	Egy alkalmazást/xml-t jelöl.
image/jp2	Egy kép/jp2 képet jelöl.
image/jpeg	Egy képet/jpeg-et jelöl.
image/jpg	Egy képet/jpg-t jelöl.
image/png	Egy képet/png-t jelöl.
image/tiff; application=geotiff	Egy képet/tiff-et jelöl az application=geotiff paranccsal.
image/webp	Egy képet/webp-t jelöl.
text/html	Szöveget/html-t jelöl.
text/plain	Szöveget/sima szöveget jelöl.

Megosztás a következőn keresztül:

Stac Landing Pages - Get

URI-paraméterek

Válaszok

Biztonság

OAuth2Auth

Hatókörök

Példák

StacLandingPages_Get

Mintakérelem

Mintaválasz

Definíciók

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

LandingPage

Link

LinkType