Skip to main content

Order Request Body

A customer can have multiple orders active at the same time to obtain different data products for varied use cases or to set different image revisit frequencies for distinct areas. An order can consist of one or many geometries that share the same order settings. While we strive to offer maximum flexibility in the ordering process, there are some limits. Orders can contain historical and/or live images, and an order is automatically renewed if it includes live data. Orders can be cancelled until one day before renewing at the start of the following month. Below are the order settings that can be adjusted for a given order.

An example order request body:

{
  "Wkt": "GEOMETRYCOLLECTION (POLYGON ((8.675127 55.962365, 8.675136 55.962394, 8.675146 55.962427, 8.675156 55.962461, 8.675336 55.962602, 8.675523 55.96269, 8.675524 55.96269, 8.675733 55.962743, 8.675734 55.962743, 8.676139 55.962787, 8.677094 55.962876, 8.677469 55.962962, 8.677689 55.963047, 8.678069 55.963171, 8.678104 55.963182, 8.67811 55.963184, 8.678112 55.963184, 8.678751 55.963407, 8.679153 55.963118, 8.679211 55.963077, 8.67928 55.963027, 8.679316 55.963001, 8.679411 55.962933, 8.678925 55.962744, 8.678573 55.962566, 8.678536 55.962547, 8.678282 55.962418, 8.677587 55.962061, 8.677558 55.962046, 8.675246 55.962311, 8.675127 55.962365",
  "TileGuids": [ ],
  "MiniTileGuids": [ ],
  "SatelliteConstellations": [
    "Sentinel1",
    "Sentinel2",
    "Landsat89"
    ],
  "Model": "Stratus2",
  "StorageMonths": 2,
  "ApiRequests": 2,
  "ImageFrequency": 2,
  "ReferenceDate": "2023-06-01",
  "From": "2023-06-01",
  "To": null
}

Area of Interest​

The Area of Interest (AOI) defines the geographical location for which you want to receive data. For composite orders, the AOI is defined using Wkt and GeoJson and must be specified as a GeometryCollection containing Polygons and/or MultiPolygons. Each geometry is converted into its extent, which is then used for the ordering process. You can use our order estimate endpoint to see how your composite AOI will be modified. Read more about this in our Area of Interest Guide. For tiles and minitiles, the AOI is defined using TileGuids and MiniTileGuids. All tiles and minitiles are predefined and the geometry is not editable but discounts are provided as it's more efficent.

Models and Satellites​

The Model refers to the artificial intelligence model used to fuse satellite images and remove cloud cover. We operate multiple models to accommodate different user applications and maximize value through diverse opportunities. Each available model has its own base price, benefits and downsides, and specific available input satellites. The input satellites are specified using SatelliteConstellations. You can read more about our available models and which input satellites are available in our Cloud-Removal Models Guide.

From, To, Image Frequency and Reference Date​

  • From Date: From specifies the first month for which you wish to receive imagery. For historical data, this is the earliest month in your requested period. The From month must be equal to or before the current month.

  • To Date: To, applicable primarily for historical data, defines the end of the requested date range. For recurring live data, leave the To field empty, as the service continues each month without a predetermined end.

  • Image Frequency: The ImageFrequency determines how often new satellite images are delivered for your order. Available options range from daily (1) to weekly (7). If different image frequencies are needed for a given area, split it into multiple orders.

  • Reference Date: ReferenceDate refers to the starting date of the chosen image frequency. This date is used to control and align the continuous flow of images. The standard reference date is the first day of the first month, but it can be modified by the user when placing an order. This is particularly useful for customers with multiple orders made in different months, allowing all images on their platform to align with the same frequency.

API Requests and Data Storage​

  • API Requests: Allow you to programmatically interact with the data through our API endpoints. This setting determines the number of API download requests you can make to retrieve or process the imagery. You can customize your request quota based on anticipated usage to ensure smooth integration with your data workflows.

  • Data Storage: Refers to the duration for which your satellite imagery and data remain available for download and use. You can choose a unique storage duration for each order, with the first month being free. Additional storage costs apply for keeping data available longer, ensuring you have ample time to access and use the imagery.