Overlap Object

Overlap details are only provided if searching by a bounding box (or polygon in the future), it will be absent if searching by a point. The Overlap object has the following structure:

{
  "area": 0,
  "percent": 0,
  "polygon": []
}

field	data type	purpose
area	number	area in sq km of the overlap between search and result
percent	number	percent of the original search area this scene overlaps
polygon	[][]number	polygon of overlap area

Pricing Object

Many suppliers require different licencing or pricing to licence additional seats to the imagery, as well as allowing purchase of whole scenes, or just the Area Of Interest (AOI), this object provides details for the different pricing options.
All pricing is provided in US cents.
Depending on your search criteria, two different prices may be available for your imagery.
The price object provides these details, as well as which options are available.
The price object has two fields:
- scene: which provides pricing for purchasing a whole image capture (what you see in the thumbnail image), or
- aoi: which is only available if searching by an area (much like the overlap object above), and provides pricing for only purchasing the imagery in your search area. This field may also be absent, indicating an inability to purchase only the AOI portion of this scene, for any of the following reasons:
 - the supplier does not support AOI ordering (such as landsat)
 - the portion of your AOI within this scene is less than the suppliers minimum order
 - the portion of your AOI within this scene fails supplier swath width requirements
The contents of the scene and aoi fields is a pricing object, which has the following structure:

{
  "base": 0,
  "seats": [
      {
          "min": 0,
          "max": 0,
          "additional": 0
      }
  ]
}

field	data type	purpose
base	number	the base static price for the imagery, this is the portion the image will always cost
seats	array	each organisation that uses the image constitutes a seat. If you are distributing this image to other organisations, this will apply. Please consult the EULA for more information.
min	number	minimum number of seats to which this price range applies
max	number	maximum number of seats to which this price range applies (0 represents no maximum)
additional	number	the additional price to be paid in this range

All imagery will cost its base price, and purchases with additional seats may attract additional charges, described by this structure.
If the seats array is empty, no additional charge is applicable for any seat number.
If the seats array is populated, each object represents pricing for a range of seats and the additional amount to be added to base for purchasing this imagery.
The applicable entry is one where the required number of seats is:
- greater than or equal to that entry's min value
- less than or equal to that entry's max value, or that entry's max value is 0 (representing no upper bounds)
When purchasing the imagery, the amount charges to the requesting users account will be base + additional for the appropriate seats entry.

Version 1.0.0:

Initial version of API, supported:

• search imagery
• order imagery
• orders list
• order get
• order
• resource get

Version 1.1.0:

Internal update for platform update:

• added signature management internal api
• added admin pages to manage orders

Version 1.2.0:

Added SI Imaging as an imagery supplier/vendor

Version 1.3.0:

Added signup procedure for non activated accounts

Version 2.0.0:

AOI ordering for imagery
Search response structure changed:

• added sceneID field
• added annotations
• field - changed overlap to object with children:
  • area
  • percent
  • polygon
• Changed price field to include new field aoi which also contains pricing information for AOI order

Order object changes:

• added trim field