Stac Landing Pages - Get

Odwołanie

Usługa:: Planetary Computer

Wersja interfejsu API:: 2025-04-30-preview

Strona docelowa
Punkt końcowy.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	LandingPage	Żądanie zakończyło się pomyślnie.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Nazwa

Typ

Opis

200 OK

LandingPage

Żądanie zakończyło się pomyślnie.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://geocatalog.spatio.azure.com/.default

Przykłady

StacLandingPages_Get

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 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": []
}

Definicje

Nazwa	Opis
Azure.Core.Foundations.Error	Obiekt błędu.
Azure.Core.Foundations.ErrorResponse	Odpowiedź zawierająca szczegóły błędu.
Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — 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 Reprezentuje stronę docelową interfejsu API STAC z linkami do dostępnych zasobów.
Link	Model połączenia. Ref: http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml Reprezentuje łącze.
LinkType	Typy MIME dla linków.

Azure.Core.Foundations.Error

Objekt

Obiekt błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	Azure.Core.Foundations.Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	Azure.Core.Foundations.Error	Obiekt błędu.

Azure.Core.Foundations.InnerError

Objekt

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
innererror	Azure.Core.Foundations.InnerError	Błąd wewnętrzny.

LandingPage

Objekt

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

Reprezentuje stronę docelową interfejsu API STAC z linkami do dostępnych zasobów.

Nazwa	Typ	Domyślna wartość	Opis
conformsTo	string[] (uri)		Lista klas zgodności API OGC zaimplementowanych przez ten interfejs API.
description	string minLength: 1		Szczegółowy opis katalogu STAC.
id	string minLength: 1		Niepowtarzalny identyfikator katalogu STAC.
links	Link[]		Łącza do powiązanych zasobów i punktów końcowych.
msft:_created	string		Utworzono program MSFT
msft:_updated	string		Zaktualizowano MSFT
msft:short_description	string maxLength: 300		Krótki opis MSFT
stac_extensions	string[]		Adresy URL rozszerzeń STAC zaimplementowanych przez ten zasób STAC.
stac_version	string	1.0.0	Wersja Stac
title	string		Czytelny dla człowieka tytuł katalogu STAC.
type	string minLength: 1	Catalog	Typ

Link

Objekt

Model połączenia.

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

Reprezentuje łącze.

Nazwa	Typ	Domyślna wartość	Opis
body	object		W przypadku żądań POST zasób może określić treść HTTP jako obiekt JSON.
headers	object		Pary klucz-wartość obiektów, które są mapowane na nagłówki. Przykład: { "Accept": "application/json" }.
href	string		Adres URL linku.
hreflang	string		Język połączonego zasobu.
length	integer (int32)		Długość połączonego zasobu.
merge	boolean	False	Wskazuje, czy oczekuje się, że klient scali wartość treści z bieżącą treścią żądania przed skorzystaniem z linku. Jest to ważne tylko wtedy, gdy serwer odpowiada na żądanie POST. Wartość domyślna: false.
method	enum: GET POST	GET	Określa metodę HTTP oczekiwaną przez zasób. Domyślnie: POBIERZ.
rel	string		Typ relacji łącza.
title	string		Tytuł linku.
type	LinkType	application/json	Typ MIME połączonego zasobu.

LinkType

Wyliczanie

Typy MIME dla linków.

Wartość	Opis
application/geo+json	Reprezentuje application/geo+json.
application/json	Reprezentuje aplikację/json.
application/x-binary	Reprezentuje plik binarny application/x.
application/x-protobuf	Reprezentuje application/x-protobuf.
application/xml	Reprezentuje application/xml.
image/jp2	Reprezentuje obraz/jp2.
image/jpeg	Reprezentuje obraz/jpeg.
image/jpg	Reprezentuje obraz/jpg.
image/png	Reprezentuje obraz/png.
image/tiff; application=geotiff	Reprezentuje obraz/tiff z application=geotiff.
image/webp	Reprezentuje obraz/webp.
text/html	Reprezentuje tekst/html.
text/plain	Reprezentuje tekst/zwykły.

Udostępnij za pośrednictwem

Stac Landing Pages - Get

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

OAuth2Auth

Zakresy

Przykłady

StacLandingPages_Get

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

LandingPage

Link

LinkType