directView

Create Custom DirectView Tiles

Generate customized XYZ tile URLs with control over band selection and histogram stretching. Returns detailed tile information organized by interval ID and capture date, including tile URLs, bounds, and zoom limits. Authentication required via x-api-key header.

post/createxyz

Request

Base URL
https://api.skywatch.co/earthcache
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/skywatch/apis/api-specification/docs/createxyz/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

pipelineIDstring required

Pipeline identifier to generate tiles for

histogramStretchstring

Histogram stretching method: 'minmax' (simple min/max), 'stdev' (mean ± 2 * std dev, customizable as 'stdev_3'), 'cumulativecutcount' (2-98% cutoff, customizable as 'cumulativecutcount_1_99'). Default: 'stdev'

bandListstring[]

List of band names in desired order (e.g., ['red', 'green', 'blue']). Must match band names from SkyWatch Standard Product metadata.

timeLimitstring

Time-limited access format: '7d' (7 days), '0.5M' (15 days), '1y8M12d16h30m15s' (custom duration), 'never' (no expiry). Coming soon.

Example request

{
  "histogramStretch": "stdev",
  "bandList": [
    "red",
    "green",
    "blue"
  ],
  "timeLimit": "never"
}

Response

Success

statusCodeinteger

bodyobject

Nested structure organized by interval ID and capture date

Example response

{
  "statusCode": 200
}

Changes

No recorded changes to this operation across all 1 revision of this API.