Crop

Crops raster tiles from a primary provider to a specific geographic area and displays tiles from a secondary provider in the remaining areas.

This is similar to the bounds parameter in the Fallback provider but specific to raster tiles. This provides a cleaner edge when zooming in and out but has greater overhead due to the image processing that occurs.

Name should be "crop"

Configuration options:

Parameter	Description	Type	Required	Default
primary	The provider of the imagery to crop	Provider	Yes	None
secondary	The provider to supply the imagery to use in areas that are cropped out	Provider	Yes	None
bounds	Any pixels that fall outside these geographic bounds (in WGS-84/EPSG:4326) will be removed.	Object with north, south, east, west	No	Whole world
boundsFromAuth	If true, use the bounds supplied via the auth context such as the geohash claim in JWT auth. If no bounds are specified via auth context then it falls back on the bounds parameter.	Boolean	No	No

Parameter

Description

Type

Required

Default

primary

The provider of the imagery to crop

Provider

Yes

None

secondary

The provider to supply the imagery to use in areas that are cropped out

Provider

Yes

None

bounds

Any pixels that fall outside these geographic bounds (in WGS-84/EPSG:4326) will be removed.

Object with north, south, east, west

Whole world

boundsFromAuth

If true, use the bounds supplied via the auth context such as the geohash claim in JWT auth. If no bounds are specified via auth context then it falls back on the bounds parameter.

Boolean

Example:

provider:
  name: crop
  bounds:
    south: 51
    north: 63
    west: -7
    east: 0.1
  primary:
    name: proxy
    url: https://tile.openstreetmap.org/{z}/{x}/{y}.png
  secondary:
    name: static
    color: "0000"