---
title: "Get Interval Legend"
method: GET
path: "/data/legend/interval/{classmapName}"
tags: ["Map Legends"]
---

# Get Interval Legend

`GET /data/legend/interval/{classmapName}`

Generate values and color swatches mapping for a given interval classmap.

Returns a color map for intervals, where each interval is defined by
a numeric range [min, max] representing the interval boundaries and
an RGBA color [red, green, blue, alpha] associated with the interval.

The response is a 2D array of interval definitions, where each element is a pair:
the first element is an array of two numbers [min, max] defining the interval,
and the second element is an array of four numbers [red, green, blue, alpha] defining the RGBA color.

Example: [[ [-2, 0], [0, 0, 0, 0] ], [ [1, 32], [255, 255, 178, 255] ]].
This defines two intervals: [-2, 0] mapped to transparent black and [1, 32] mapped to opaque yellow.

## Path parameters

- `classmapName` string, required

## Query parameters

- `api-version` string, required
- `trim_start` integer
- `trim_end` integer

## Response `200`

Interval legend response model.

Represents a color map for intervals, where each interval is defined by:
- A numeric range `[min, max]` representing the interval boundaries.
- An RGBA color `[red, green, blue, alpha]` associated with the interval.

The response is a 2D array of interval definitions, where each element is a pair:
- The first element is an array of two numbers `[min, max]` defining the interval.
- The second element is an array of four numbers `[red, green, blue, alpha]` defining the RGBA color.

Example:
```json
[
  [
    [-2, 0], [0, 0, 0, 0]
  ],
  [
    [1, 32], [255, 255, 178, 255]
  ]
]
```
This example defines two intervals:
- The interval `[-2, 0]` is mapped to the color `[0, 0, 0, 0]` (transparent black).
- The interval `[1, 32]` is mapped to the color `[255, 255, 178, 255]` (opaque yellow).

- array[]
  - array[]
    - integer[]

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.net/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/versions/42447be18bc5/schema)