Skip to main content

Ordering with Tiles

Understand Tiles​

The default ordering method is a flexible composite order, designed to meet most user needs. However, for grand-scale monitoring, customers can order entire predefined ClearSKY tiles and benefit from a 90% reduction in base prices compared to a standard composite order.

Key Points:

  • Tile Characteristics:
    Tiles have a defined number of pixels, which depends on the original distribution by the satellite imagery provider (Copernicus/ESA). Most tiles are 5120x5120 pixels in size and only deviate in edges of Universal Transverse Mercator (UTM) zones.

  • Bulk Ordering:
    For bulk orders, refer to our tile map to understand the size and placement of these tiles. It's crucial to understand their placement, as they are predefined with no flexibility for tile placement.

  • Ordering Process:
    Aside from the enforced tile geometry and the associated discount, the ordering process for tile orders is identical to that of composite orders, with flexible image frequencies and model selection.

Draw using the leaflet polygon tool to see the predefined tiles on the map for a given UTM zone.

Understand Minitiles​

We have recently introduced 'minitiles' which are 320x320 pixels in size, and similarly to tiles, only deviate in size in edges of UTM zones. An order can consist of both tiles and minitiles. Minitiles benefit from a 50% reduction in base prices.

Tile Search via API​

You can also search for orderable tiles (and optional minitiles) via a POST request to:

POST /api.clearsky.vision/api/tasking/search/tiles

Request Body (JSON):

{
  "Wkt": "POLYGON((7.6 51.9,7.6 52.0,7.7 52.0,7.7 51.9,7.6 51.9))",
  "Guids": ["{tile-guid-1}", "{tile-guid-2}"],
  "IncludeMinitiles": true
}

Response (JSON):

{
  "foundTiles": [
    {
      "guid": "{tile-guid-1}",
      "utmZone": "33N",
      "geometry": { "type": "Polygon", "coordinates": [...] }
    }
  ],
  "foundMinitiles": [...]
}
tip

Each tile returned by the API includes an EPSG code and a DataGeogWkt to help interpret its spatial data. You can also refine your search by supplying tile GUIDs or GeoJSON geometry. Read more at api.clearsky.vision.