Tiler Static Images - Create

Referencia

Szolgáltatás:: Planetary Computer

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

Statikus kép létrehozása
Hozzon létre egy új képexportálást.

POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/{collectionId}/image/static?api-version=2025-04-30-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
collectionId	path	True	string maxLength: 500 pattern: .*	STAC gyűjtemény azonosítója
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
cols	True	integer (int32)	A kimeneti kép szélessége képpontban
cql	True	Cql	Cql
render_params	True	string	JSON-kódolású vizualizációs paraméterek
rows	True	integer (int32)	A kimeneti kép magassága képpontban
format		ImageRequestFormat	A generált kép kimeneti formátuma
geometry		GeoJson	Geometria
mask		boolean	Maszkolás alkalmazása érvénytelen vagy adatmentes területekre
showBranding		boolean	A márkajelzés szerepeltetése a kimeneti képen

Válaszok

Name

Típus

Description

200 OK

file

Kép visszaadása.

Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json"

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Media Types: "image/png", "image/jpeg", "image/jpg", "image/webp", "image/jp2", "image/tiff; application=geotiff", "application/x-binary", "application/json"

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

TilerStaticImages_Create

Mintakérelem

HTTP

POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/data/collections/collectionId-23/image/static?api-version=2025-04-30-preview

{
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -79.09062791441062,
          43.08554661560049
        ],
        [
          -79.0629876337021,
          43.08554661560049
        ],
        [
          -79.0629876337021,
          43.067969831431895
        ],
        [
          -79.09062791441062,
          43.067969831431895
        ],
        [
          -79.09062791441062,
          43.08554661560049
        ]
      ]
    ]
  },
  "cql": {
    "filter-lang": "cql2-json",
    "filter": {
      "op": "and",
      "args": [
        {
          "op": "=",
          "args": [
            {
              "property": "collection"
            },
            "naip"
          ]
        }
      ]
    }
  },
  "render_params": "assets=image&asset_bidx=image|1,2,3&collection=naip",
  "cols": 1080,
  "rows": 1080,
  "showBranding": true
}

Mintaválasz

Állapotkód:: 200

"raw png file bytes"

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.
Cql	CQL modell
CqlFilter	CQL szűrő modell
ImageRequest	Renderelt kép gyűjteményből való kérésének paraméterei
ImageRequestFormat	A képkérések kimenetének formátumspecifikációja
SortBy	SortBy modell

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.

Cql

Objektum

CQL modell

Name	Típus	Description
filter	CqlFilter	Szűrő
filter-lang	string	Szűrő nyelv
sortby	SortBy[]	Rendezési szempont:

CqlFilter

Objektum

CQL szűrő modell

Name	Típus	Description
args	CqlArgument[]	A logikai operátor argumentumai
op	string	Logikai operátor

ImageRequest

Objektum

Renderelt kép gyűjteményből való kérésének paraméterei

Name	Típus	Alapértelmezett érték	Description
cols	integer (int32)		A kimeneti kép szélessége képpontban
cql	Cql		Cql
format	ImageRequestFormat	png	A generált kép kimeneti formátuma
geometry	GeoJson		Geometria
mask	boolean		Maszkolás alkalmazása érvénytelen vagy adatmentes területekre
render_params	string		JSON-kódolású vizualizációs paraméterek
rows	integer (int32)		A kimeneti kép magassága képpontban
showBranding	boolean	True	A márkajelzés szerepeltetése a kimeneti képen

ImageRequestFormat

Enumerálás

A képkérések kimenetének formátumspecifikációja

Érték	Description
cog	Felhőre optimalizált GeoTIFF formátum
png	Hordozható hálózati grafikus formátum

SortBy

Objektum

SortBy modell

Name	Típus	Description
direction	string	Rendezés iránya
field	string	Rendezési mező