Language

Detailed step-by-step explanations for Pléiades Neo tasking

Step 1: Authenticate

Using you API Key, you will need to get an access token that enables authorization. Authorization refers to the process of determining what permissions an authenticated client has for a set of resources.
For security reasons this access token expires regularly then it’s necessary to renew the authentication process to get a new one.
Please refer to the dedicated Authentication Guide

Step 2: AOI Tutorial

For any request over a location you will be asked to define an AOI (Area Of Interest). This AOI definition follows the requirement of GeoJSON specifications, which is an open standard format designed for representing simple geographical features. The specified AOI must always have a GeoJSON geometric type (Polygon, Point, LineString, etc) and coordinates. The only supported type in our case is Polygon, which defines a shape composed by straight lines.

The coordinates of the polygon are an array of points defined by latitude and longitude. They must follow certain rules:

  • The first and last point are the same

  • The points define the outline of the shape. Complex shapes with multiples points are accepted up to 999 vertices.

  • Each AOI must have at least 4 coordinates (triangle)

  • An AOI with a “hole” inside (donut shape) is forbidden.

    Forbidden donut shape aoi

  • The order of the points is important. Each line defined between two consecutive points must not intersect with any other line of the polygon.

    • {“type”:“Polygon”,“coordinates”:[[[2.0,1.0],[1.0,1.0],[1.0,2.0],[2.0,2.0],[2.0,1.0]]]} is good

      Allowed shape aoi

    • {“type”:“Polygon”,“coordinates”:[[[2.0,1.0],[1.0,2.0],[1.0,1.0],[2.0,2.0],[2.0,1.0]]]} is not good

    Forbidden shape aoi with intersection

If you need to use a map to draw your AOI, you may use the AOI manager that is available within the OneAtlas platform. It allows a user to draw complex shapes and export the coordinates in many different formats that may suit your needs.

AOI manager menu

Step 3: Check Feasibility

The following request returns an automatic feasibility study result for the requested tasking. This allows to:

  • know if the request needs to go through manual feasibility study (AUTOMATIC or MANUAL)

  • get the ‘difficulty’ of your request in case of a OnePlan automatic request (EASY or CHALLENGING with an impact on price)

ProgTypeNames can be:

  • For Pléiades Neo: ONEPLAN, ONEDAY, ONENOWATTEMPTS, ONENOWWEATHER

  • For SPOT & Pléiades: ONEPLAN, ONEDAY, ONENOW , ONESERIES

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/feasibility
REST verbPOST
AuthenticationBearer token

Body request sample:

 {
  "acquisitionDate": {
    "endDate": "2021-06-11T23:59:59.999Z",
    "startDate": "2021-05-12T11:03:19.052Z"
  },
  "contractId": "<CisContractId>",
  "missions": [
    "PLEIADESNEO"
  ],
  "optical": {
    "acquisitionMode": "MONO",
    "maxCloudCover": 10,
    "maxIncidenceAngle": 50
  },
  "progTypeNames": [
    "ONEPLAN"
  ],
  "aoi": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          1.4316558837890625,
          43.568824930165476
        ],
        [
          1.4316558837890625,
          43.601900054609445
        ],
        [
          1.4670181274414062,
          43.601900054609445
        ], 
        [
          1.4670181274414062,
          43.568824930165476
        ],
        [
          1.4316558837890625,
          43.568824930165476
        ]
      ]
    ]
  }
}

Response

{
"progCapacities": [
        {
            "mission": "PLEIADESNEO",
            "progTypes": [
                {
                    "name": "ONEPLAN",
                    "mission": "PLEIADESNEO",
                    "feasibility": {
                        "classification": "CHALLENGING",
                        "automation": "AUTOMATIC"
                    },
                    "available": true,
                    "expirationDate": "2021-05-12T08:03:19.052Z"

                }
            ]
        }
    ]
}

classification and automation will be needed later.

If the automation is “MANUAL” a feasibility study will be needed. A feasibility study is a diagnosis performed by our tasking experts in order to organise the acquisition plan and estimate the confidence in covering the area of interest within the defined acquisition period and parameters. To study the feasibility of the tasking request, we ask the customer: where, by when and for which application the customer needs the new collection(s). With this information, the Tasking Team issues a tasking proposal.

Step 4: Get Attempts

Note: This step is only mandatory (and available) for ONEDAY and ONENOWATTEMPTS.

This API allows to get the first possible attempts matching your criteria, within a 7-day timeframe from the defined start date.
Start date can be set at any time. Note that if you try to set it in the past, the value will be replace by the current date.

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/attempts
REST verbPOST
AuthenticationBearer token

Body request sample:

{
    "progTypeNames": [
        "ONEDAY"
    ],
    "missions": [
        "PLEIADESNEO"
    ],
    "contractId": "<CisContractId>",
    "acquisitionDate": {
        "startDate": "2021-04-16T00:16:26.665Z",
        "endDate": null
    },
    "optical": {
        "acquisitionMode": "MONO",
        "maxCloudCover": 25,
        "maxIncidenceAngle": 30
    },
    "aoi": {
        "type": "Polygon",
        "coordinates": [
            [
                [1.3763809204101562, 43.545313140623726],
                [1.5095901489257812, 43.545313140623726],
                [1.5095901489257812,.656198305413156],
                [1.3763809204101562, 43.656198305413156],
                [1.3763809204101562, 43.545313140623726
]
            ]
        ]
    }
}

Response example

{
    "progCapacities": [
        {
            "mission": "PLEIADESNEO",
            "progTypes": [
                {
                    "name": "ONEDAY",
                    "mission": "PLEIADESNEO",
                    "segments": [
                        {
                            "id": "PNEO1",
                            "footprint": {
                                "geometry": "POLYGON((1.290924 43.66588, 1.291362 43.535844, 1.594352 43.534532, 1.594753 43.665881, 1.290924 43.66588, 1.290924 43.66588))",
                                "center": "POINT(1.443102 43.600564)"
                            },
                            "instrumentMode": "THR",
                            "orderDeadline": "2022-12-14T10:11:00.599Z",
                            "extendedAngle": false,
                            "acquisitionStartDate": "2022-12-14T10:57:49.599Z",
                            "acquisitionEndDate": "2022-12-14T10:57:51.719Z",
                            "incidenceAngle": 46.74,
                            "segmentKey": "1f4d4c3d154d3b5c423926de121272546ef7f28df14eab7d3782c5de8dc04cfb84d0f4b0c00070db051858d4b0cf7f0826970f85dd8bea1d6f0864518c480f95::[{\"key\":\"orderDeadLine\",\"value\":\"2022-12-14T10:11:00.599Z\"},{\"key\":\"acqPeriod\",\"value\":\"2022-12-14T10:57:49.599Z 2022-12-14T10:57:51.719Z\"},{\"key\":\"maxIncidenceAngle\",\"value\":\"50.0\"},{\"key\":\"geometryWkt\",\"value\":\"POLYGON((1.290924 43.66588, 1.291362 43.535844, 1.594352 43.534532, 1.594753 43.665881, 1.290924 43.66588, 1.290924 43.66588))\"}]",
                            "acrossTrackIncidenceAngle": 8.774633810945508,
                            "maxIncidenceAngle": 50.0
                        },
                        {
                            "id": "PNEO2",
                            "footprint": {
                                "geometry": "POLYGON((1.236331 43.665838, 1.23766 43.535286, 1.642634 43.535027, 1.643896 43.665852, 1.236331 43.665838, 1.236331 43.665838))",
                                "center": "POINT(1.440201 43.60057)"
                            },
                            "instrumentMode": "THR",
                            "orderDeadline": "2022-12-15T09:42:00.990Z",
                            "extendedAngle": true,
                            "acquisitionStartDate": "2022-12-15T10:28:55.099Z",
                            "acquisitionEndDate": "2022-12-15T10:28:57.219Z",
                            "incidenceAngle": 45.97,
                            "segmentKey": "795a5fa8de582be9d4d946e705152d5d4ecc635d558c75c02aff57ff388204329af56355aa8ccc95a69cccbe54c8f7274a820ac7dcdc0de03b1ced63120bd231::[{\"key\":\"orderDeadLine\",\"value\":\"2022-12-15T09:42:00.990Z\"},{\"key\":\"acqPeriod\",\"value\":\"2022-12-15T10:28:55.099Z 2022-12-15T10:28:57.219Z\"},{\"key\":\"maxIncidenceAngle\",\"value\":\"50.0\"},{\"key\":\"geometryWkt\",\"value\":\"POLYGON((1.236331 43.665838, 1.23766 43.535286, 1.642634 43.535027, 1.643896 43.665852, 1.236331 43.665838, 1.236331 43.665838))\"}]",
                            "acrossTrackIncidenceAngle": -42.04646667914757,
                            "maxIncidenceAngle": 50.0
                        },
                        {
                            "id": "PNEO3",
                            "footprint": {
                                "geometry": "POLYGON((1.278574 43.66587, 1.278022 43.535525, 1.610332 43.534811, 1.60973 43.665863, 1.278574 43.66587, 1.278574 43.66587))",
                                "center": "POINT(1.444314 43.600479)"
                            },
                            "instrumentMode": "THR",
                            "orderDeadline": "2022-12-15T10:30:00.699Z",
                            "extendedAngle": true,
                            "acquisitionStartDate": "2022-12-15T11:16:49.699Z",
                            "acquisitionEndDate": "2022-12-15T11:16:51.819Z",
                            "incidenceAngle": 46.23,
                            "segmentKey": "1bc066138b355f4c0b88d76caf3e17521c972be7ba027d2cf977c0aa40e554b4a6da0a36b33d5ce74ca02e4067d55b8b4267be09bc3f004ee9762801ab5bc434::[{\"key\":\"orderDeadLine\",\"value\":\"2022-12-15T10:30:00.699Z\"},{\"key\":\"acqPeriod\",\"value\":\"2022-12-15T11:16:49.699Z 2022-12-15T11:16:51.819Z\"},{\"key\":\"maxIncidenceAngle\",\"value\":\"50.0\"},{\"key\":\"geometryWkt\",\"value\":\"POLYGON((1.278574 43.66587, 1.278022 43.535525, 1.610332 43.534811, 1.60973 43.665863, 1.278574 43.66587, 1.278574 43.66587))\"}]",
                            "acrossTrackIncidenceAngle": 39.221179859710745,
                            "maxIncidenceAngle": 50.0
                        },
                        {
                            "id": "PNEO4",
                            "footprint": {
                                "geometry": "POLYGON((1.283525 43.665871, 1.284393 43.535709, 1.600055 43.534658, 1.600882 43.665875, 1.283525 43.665871, 1.283525 43.665871))",
                                "center": "POINT(1.442427 43.600586)"
                            },
                            "instrumentMode": "THR",
                            "orderDeadline": "2022-12-16T10:00:00.399Z",
                            "extendedAngle": false,
                            "acquisitionStartDate": "2022-12-16T10:46:45.399Z",
                            "acquisitionEndDate": "2022-12-16T10:46:47.519Z",
                            "incidenceAngle": 46.5,
                            "segmentKey": "1ecb073fbcc425afe0ebe45e8a1469ff324eea9af5ceee5a9e0b036e3cd90930861cfaaa83f7b3003c87fa79736e98cc3e2fd48758308881ee16c2e511b17411::[{\"key\":\"orderDeadLine\",\"value\":\"2022-12-16T10:00:00.399Z\"},{\"key\":\"acqPeriod\",\"value\":\"2022-12-16T10:46:45.399Z 2022-12-16T10:46:47.519Z\"},{\"key\":\"maxIncidenceAngle\",\"value\":\"50.0\"},{\"key\":\"geometryWkt\",\"value\":\"POLYGON((1.283525 43.665871, 1.284393 43.535709, 1.600055 43.534658, 1.600882 43.665875, 1.283525 43.665871, 1.283525 43.665871))\"}]",
                            "acrossTrackIncidenceAngle": -12.344516409609247,
                            "maxIncidenceAngle": 50.0
                        },
                        {
                            "id": "PNEO5",
                            "footprint": {
                                "geometry": "POLYGON((1.290938 43.665882, 1.291017 43.535785, 1.595517 43.534586, 1.595559 43.66588, 1.290938 43.665882, 1.290938 43.665882))",
                                "center": "POINT(1.443491 43.600537)"
                            },
                            "instrumentMode": "THR",
                            "orderDeadline": "2022-12-17T10:19:00.499Z",
                            "extendedAngle": false,
                            "acquisitionStartDate": "2022-12-17T11:05:19.499Z",
                            "acquisitionEndDate": "2022-12-17T11:05:21.619Z",
                            "incidenceAngle": 46.63,
                            "segmentKey": "dacdc309a9b9cbee6a800d0bf621bfec7bbc750aa1abfefea7aa0dfc8727a6364c4a04207676f697537cf1c1f5b5aa38e1a36a3c409924c67945accb188c0bee::[{\"key\":\"orderDeadLine\",\"value\":\"2022-12-17T10:19:00.499Z\"},{\"key\":\"acqPeriod\",\"value\":\"2022-12-17T11:05:19.499Z 2022-12-17T11:05:21.619Z\"},{\"key\":\"maxIncidenceAngle\",\"value\":\"50.0\"},{\"key\":\"geometryWkt\",\"value\":\"POLYGON((1.290938 43.665882, 1.291017 43.535785, 1.595517 43.534586, 1.595559 43.66588, 1.290938 43.665882, 1.290938 43.665882))\"}]",
                            "acrossTrackIncidenceAngle": 22.155855494590615,
                            "maxIncidenceAngle": 50.0
                        },
                        {
                            "id": "PNEO6",
                            "footprint": {
                                "geometry": "POLYGON((1.263007 43.665848, 1.264162 43.535441, 1.618393 43.534886, 1.619496 43.665857, 1.263007 43.665848, 1.263007 43.665848))",
                                "center": "POINT(1.441393 43.600577)"
                            },
                            "instrumentMode": "THR",
                            "orderDeadline": "2022-12-18T09:49:00.299Z",
                            "extendedAngle": true,
                            "acquisitionStartDate": "2022-12-18T10:35:54.299Z",
                            "acquisitionEndDate": "2022-12-18T10:35:56.419Z",
                            "incidenceAngle": 46.23,
                            "segmentKey": "0c00b3119cd3ce671383b674bb4baa0f5b96304fffc9f34d7035a1f2ac5ce56a041ef7878b0c7e0446e2f09fad068d496b997de0b99b299f44321f8913133d44::[{\"key\":\"orderDeadLine\",\"value\":\"2022-12-18T09:49:00.299Z\"},{\"key\":\"acqPeriod\",\"value\":\"2022-12-18T10:35:54.299Z 2022-12-18T10:35:56.419Z\"},{\"key\":\"maxIncidenceAngle\",\"value\":\"50.0\"},{\"key\":\"geometryWkt\",\"value\":\"POLYGON((1.263007 43.665848, 1.264162 43.535441, 1.618393 43.534886, 1.619496 43.665857, 1.263007 43.665848, 1.263007 43.665848))\"}]",
                            "acrossTrackIncidenceAngle": -31.4398087955519,
                            "maxIncidenceAngle": 50.0
                        },
                        {
                            "id": "PNEO7",
                            "footprint": {
                                "geometry": "POLYGON((1.289609 43.665879, 1.290207 43.535825, 1.595111 43.534551, 1.595671 43.665881, 1.289609 43.665879, 1.289609 43.665879))",
                                "center": "POINT(1.442898 43.600575)"
                            },
                            "instrumentMode": "THR",
                            "orderDeadline": "2022-12-19T10:08:00.999Z",
                            "extendedAngle": false,
                            "acquisitionStartDate": "2022-12-19T10:54:06.999Z",
                            "acquisitionEndDate": "2022-12-19T10:54:09.119Z",
                            "incidenceAngle": 46.65,
                            "segmentKey": "cf91fe1de4137d25b31488782a36c38a7892a837749037f268457f2b32b972be8fa6cc3b5a24b0f2332fd450bff36561e9e9feac09a51d63a55bf054f6031aa1::[{\"key\":\"orderDeadLine\",\"value\":\"2022-12-19T10:08:00.999Z\"},{\"key\":\"acqPeriod\",\"value\":\"2022-12-19T10:54:06.999Z 2022-12-19T10:54:09.119Z\"},{\"key\":\"maxIncidenceAngle\",\"value\":\"50.0\"},{\"key\":\"geometryWkt\",\"value\":\"POLYGON((1.289609 43.665879, 1.290207 43.535825, 1.595111 43.534551, 1.595671 43.665881, 1.289609 43.665879, 1.289609 43.665879))\"}]",
                            "acrossTrackIncidenceAngle": 1.740387981907362,
                            "maxIncidenceAngle": 50.0
                        },
                        {
                            "id": "PNEO8",
                            "footprint": {
                                "geometry": "POLYGON((1.285327 43.665877, 1.285007 43.53563, 1.602571 43.534724, 1.602209 43.665872, 1.285327 43.665877, 1.285327 43.665877))",
                                "center": "POINT(1.443961 43.600502)"
                            },
                            "instrumentMode": "THR",
                            "orderDeadline": "2022-12-20T10:26:00.599Z",
                            "extendedAngle": true,
                            "acquisitionStartDate": "2022-12-20T11:12:56.599Z",
                            "acquisitionEndDate": "2022-12-20T11:12:58.719Z",
                            "incidenceAngle": 46.4,
                            "segmentKey": "3234be8e285d29fcf5c22c828a3c51dcccdfde82a1b7466f4b90442d942793dc82a27e1aab45555dacec6fb005c130b930bea9dfbb4b3b00bdd538fa0ab57c4b::[{\"key\":\"orderDeadLine\",\"value\":\"2022-12-20T10:26:00.599Z\"},{\"key\":\"acqPeriod\",\"value\":\"2022-12-20T11:12:56.599Z 2022-12-20T11:12:58.719Z\"},{\"key\":\"maxIncidenceAngle\",\"value\":\"50.0\"},{\"key\":\"geometryWkt\",\"value\":\"POLYGON((1.285327 43.665877, 1.285007 43.53563, 1.602571 43.534724, 1.602209 43.665872, 1.285327 43.665877, 1.285327 43.665877))\"}]",
                            "acrossTrackIncidenceAngle": 33.98200872068135,
                            "maxIncidenceAngle": 50.0
                        }
                    ],
                    "available": true
                }
            ]
        }
    ]
}

You will receive an error message similar to the following if the AOI size is not correct.
Example:

{
    "progCapacities": [
        {
            "mission": "PLEIADESNEO",
            "progTypes": [
                {
                    "name": "ONEDAY",
                    "mission": "PLEIADESNEO",
                    "errors": [
                        {
                            "code": "ERR_MIN_AOI_AREA",
                            "locator": "AOI",
                            "message": "24.5"
                        }
                    ],
                    "segments": [],
                    "available": false
                }
            ]
        }
    ]
}        

Step 5: Calculate Price

Note: Price can be calculated ONLY for orders that does not require feasibility study - meaning either archive or AUTOMATIC tasking


API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/prices
REST verbPOST
AuthenticationBearer token

See Step 7. The body request is the same than the /orders endpoint.

Step 6: Request a quotation

Note: Quotations are mandatory only in case of non-AUTOMATIC tasking but can be requested in any cases if necessary


API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/quotations
REST verbPOST
AuthenticationBearer token

See Step 6. The body request is the same than the /orders endpoint - with one additional notification “QUOTATION_REQUEST” to be added on top of “SALES_ORDER” based on the same template.

Step 7: Create an order

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/orders
REST verbPOST
AuthenticationBearer token

Body request sample Pléiades Neo Tasking OneDay

{
    "aoi": [
        {
            "id": 1,
            "name": "Polygon 1",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            -42.49931262834877,
                            20.92430224367932
                        ],
                        [
                            -42.40303112165122,
                            20.92430224367932
                        ],
                        [
                            -42.403059936210546,
                            20.834370239032097
                        ],
                        [
                            -42.499283813789454,
                            20.834370239032097
                        ],
                        [
                            -42.49931262834877,
                            20.92430224367932
                        ]
                    ]
                ]
            }
        }
    ],
    "contractId": "<CisContractId>",
    "items": [
        {
            "notifications": [
                {
                    "name": "",
                    "channels": [
                        {
                            "type": "email",
                            "addressee": {
                                "to": [
                                    "john.doe@company.com"
                                ],
                                "cc": []
                            }
                        }
                    ],
                    "filter": {
                        "events": [
                            {
                                "event": "NEW_ACQUISITIONS"
                            }
                        ]
                    }
                },
                {
                    "name": "",
                    "channels": [
                        {
                            "type": "email",
                            "addressee": {
                                "to": [
                                    "john.doe@company.com"
                                ],
                                "cc": []
                            }
                        }
                    ],
                    "filter": {
                        "events": [
                            {
                                "event": "ACQUISITION_CAMPAIGN"
                            }
                        ]
                    }
                },
                {
                    "name": "",
                    "channels": [
                        {
                            "type": "email",
                            "addressee": {
                                "to": [
                                    "john.doe@company.com"
                                ],
                                "cc": []
                            }
                        }
                    ],
                    "filter": {
                        "events": [
                            {
                                "event": "WEATHER_PREDICTION"
                            }
                        ]
                    }
                }
            ],
            "stations": [],
            "productTypeId": "PleiadesNeoTaskingOneDay",
            "dataSourceIds": [],
            "aoiId": 1,
            "properties": [
                {
                    "key": "acqPeriod",
                    "value": "2022-12-14T13:29:57.299Z 2022-12-14T13:29:59.073Z"
                },
                {
                    "key": "orderDeadLine",
                    "value": "2022-12-14T12:36:00.299Z"
                },
                {
                    "key": "comments",
                    "value": ""
                },
                {
                    "key": "acquisitionMode",
                    "value": "MONO"
                },
                {
                    "key": "maxIncidenceAngle",
                    "value": 50
                }
            ],
            "holdback": false
        }
    ],
    "primaryMarket": "NQUAL",
    "customerReference": "<customer_reference>",
    "optionsPerProductType": [
        {
            "productTypeId": "PleiadesNeoTaskingOneDay",
            "options": [
                {
                    "key": "spectral_processing",
                    "value": "full_bundle"
                },
                {
                    "key": "radiometric_processing",
                    "value": "basic"
                },
                {
                    "key": "image_format",
                    "value": "dimap_jpeg2000_regular"
                },
                {
                    "key": "pixel_coding",
                    "value": "12bits"
                },
                {
                    "key": "processing_level",
                    "value": "primary"
                },
                {
                    "key": "licence",
                    "value": "standard"
                },
                {
                    "key": "delivery_method",
                    "value": "on_the_flow"
                }
            ]
        }
    ],
    "endUsers": [
        {
            "endUserName": "EndUSER AC002902",
            "country": "FR"
        }
    ],
    "delivery": {
        "type": "network"
    },
    "notifications": [
        {
            "name": "",
            "channels": [
                {
                    "type": "email",
                    "addressee": {
                        "to": [
                            "john.doe@company.com"
                        ],
                        "cc": []
                    }
                }
            ],
            "filter": {
                "events": [
                    {
                        "event": "DELIVERY"
                    }
                ]
            }
        },
        {
            "name": "",
            "channels": [
                {
                    "type": "email",
                    "addressee": {
                        "to": [
                            "john.doe@company.com"
                        ],
                        "cc": []
                    }
                }
            ],
            "filter": {
                "events": [
                    {
                        "event": "SALES_ORDER"
                    }
                ]
            }
        }
    ]
}


Body request sample Pléiades Neo Tasking OnePlan

{
    "aoi": [
        {
            "id": 1,
            "name": "Polygon 1",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            -42.49931262834877,
                            20.92430224367932
                        ],
                        [
                            -42.40303112165122,
                            20.92430224367932
                        ],
                        [
                            -42.403059936210546,
                            20.834370239032097
                        ],
                        [
                            -42.499283813789454,
                            20.834370239032097
                        ],
                        [
                            -42.49931262834877,
                            20.92430224367932
                        ]
                    ]
                ]
            }
        }
    ],
    "contractId": "<CisContractId>",
    "items": [
        {
            "notifications": [
                {
                    "name": "",
                    "channels": [
                        {
                            "type": "email",
                            "addressee": {
                                "to": [
                                    "john.doe@company.com"
                                ],
                                "cc": []
                            }
                        }
                    ],
                    "filter": {
                        "events": [
                            {
                                "event": "NEW_ACQUISITIONS"
                            }
                        ]
                    }
                },
                {
                    "name": "",
                    "channels": [
                        {
                            "type": "email",
                            "addressee": {
                                "to": [
                                    "john.doe@company.com"
                                ],
                                "cc": []
                            }
                        }
                    ],
                    "filter": {
                        "events": [
                            {
                                "event": "ACQUISITION_CAMPAIGN"
                            }
                        ]
                    }
                },
                {
                    "name": "",
                    "channels": [
                        {
                            "type": "email",
                            "addressee": {
                                "to": [
                                    "john.doe@company.com"
                                ],
                                "cc": []
                            }
                        }
                    ],
                    "filter": {
                        "events": [
                            {
                                "event": "BEFORE_TASKING_END",
                                "daysBeforeEnd": 7
                            }
                        ]
                    }
                }
            ],
            "stations": [],
            "productTypeId": "PleiadesNeoTaskingOnePlan",
            "dataSourceIds": [],
            "aoiId": 1,
            "properties": [
                {
                    "key": "acquisitionMode",
                    "value": "MONO"
                },
                {
                    "key": "classification",
                    "value": "EASY"
                },
                {
                    "key": "notificationThreshold",
                    "value": 25
                },
                {
                    "key": "maxCloudCover",
                    "value": 10
                },
                {
                    "key": "maxIncidenceAngle",
                    "value": 50
                },
                {
                    "key": "acqPeriod",
                    "value": "2022-12-13T23:28:54.869Z 2023-02-12T23:59:59.999Z"
                },
                {
                    "key": "feasibilityAutomation",
                    "value": "AUTOMATIC"
                }
            ],
            "holdback": false
        }
    ],
    "primaryMarket": "NQUAL",
    "customerReference": "<customer_reference>",
    "optionsPerProductType": [
        {
            "productTypeId": "PleiadesNeoTaskingOnePlan",
            "options": [
                {
                    "key": "spectral_processing",
                    "value": "full_bundle"
                },
                {
                    "key": "radiometric_processing",
                    "value": "basic"
                },
                {
                    "key": "image_format",
                    "value": "dimap_jpeg2000_regular"
                },
                {
                    "key": "pixel_coding",
                    "value": "12bits"
                },
                {
                    "key": "processing_level",
                    "value": "ortho"
                },
                {
                    "key": "dem_1",
                    "value": "best_available"
                },
                {
                    "key": "projection_1",
                    "value": "4326"
                },
                {
                    "key": "priority",
                    "value": "standard"
                },
                {
                    "key": "licence",
                    "value": "standard"
                },
                {
                    "key": "delivery_method",
                    "value": "on_the_flow"
                }
            ]
        }
    ],
    "endUsers": [
        {
            "endUserName": "EndUSER AC002902",
            "country": "FR"
        }
    ],
    "delivery": {
        "type": "network"
    },
    "notifications": [
        {
            "name": "",
            "channels": [
                {
                    "type": "email",
                    "addressee": {
                        "to": [
                            "john.doe@company.com"
                        ],
                        "cc": []
                    }
                }
            ],
            "filter": {
                "events": [
                    {
                        "event": "DELIVERY"
                    }
                ]
            }
        },
        {
            "name": "",
            "channels": [
                {
                    "type": "email",
                    "addressee": {
                        "to": [
                            "john.doe@company.com"
                        ],
                        "cc": []
                    }
                }
            ],
            "filter": {
                "events": [
                    {
                        "event": "SALES_ORDER"
                    }
                ]
            }
        }
    ]
}

Response

{
    "quotationId": "QUO22054547",
    "currency": "EUR",
    "discountPercentage": 0.0,
    "discountValue": 0.0,
    "totalAmount": 0.0
}


Notes:

  • productTypeId can be retrieved using Get product types

  • Please refer to the dedicated Get production options for processing options

  • classification and feasibilityAutomation are the results of the feasibility study step.

  • customerReference can be used throughout the ordering process to get the status of your order and find the images in your delivery workspace. It is as a consequence better to use 1 customerReference specific to each order

  • Notification on event “WEATHER_PREDICTION” is ONLY for OneDay, an e-mail is generated with the weather forecast of your acquisition about 24h before the acquisition

  • For OneDay offer, notificationThreshold and maxCloudCover will not be considered and forced to 100%

  • Dem and projection are not mandatory for primary, Dem is not mandatory for projected

  • The QUOid sent back in the response can be used to search for your order


About multi-item and multi-aoi orders:

  • The number aoiId corresponds to both the id of the aoi

  • The number 1 in dem_1 and projection_1 refers to both the aoiId

Step 8: Get your imagery product

Once delivered, the acquisition will be placed in your private workspace. You can run this request to access these images:

API Endpointhttps://search.foundation.api.oneatlas.airbus.com/api/v2/opensearch
REST verbPOST
AuthenticationBearer access token

Request

{
    "itemsPerPage": 10,
    "startPage": 1,
    "workspace": "<workspace-Id>"
}

Our search API supports following criteria:

  • acquisitionDate

  • cloudCover

  • publicationDate: this key is convenient if you want implement an automatic harvesting sequence

  • incidenceAngle

  • geometry

  • customerReference: if you used a specific reference while ordering, this will allow you to easily identify your data

Each image is returned as a GeoJSON feature under the /features[] property. The download link is part of the returned links.

Response

{
    "error": false,
    "itemsPerPage": 10,
    "startIndex": 0,
    "totalResults": 1,
    "type": "FeatureCollection",
    "features": [
        {
            "_links": {
                "delete": {
                    "href": "https://search.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094",
                    "name": "Delete",
                    "type": "HTTP"
                },
                "imagesGetBuffer": [
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/e754f4a4-15b2-47aa-a06f-4498fe2e05a3/buffer",
                        "name": "panchromatic",
                        "type": "getBuffer",
                        "resourceId": "e754f4a4-15b2-47aa-a06f-4498fe2e05a3"
                    },
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/be98dc10-46df-415c-aae9-384746d5b635/buffer",
                        "name": "multispectral",
                        "type": "getBuffer",
                        "resourceId": "be98dc10-46df-415c-aae9-384746d5b635"
                    }
                ],
                "imagesMetadata": [
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/e754f4a4-15b2-47aa-a06f-4498fe2e05a3/metadata",
                        "name": "panchromatic",
                        "type": "application/geo+json",
                        "resourceId": "e754f4a4-15b2-47aa-a06f-4498fe2e05a3"
                    },
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/be98dc10-46df-415c-aae9-384746d5b635/metadata",
                        "name": "multispectral",
                        "type": "application/geo+json",
                        "resourceId": "be98dc10-46df-415c-aae9-384746d5b635"
                    }
                ],
                "imagesWcs": [
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/e754f4a4-15b2-47aa-a06f-4498fe2e05a3/wcs",
                        "name": "panchromatic",
                        "type": "WCS",
                        "resourceId": "e754f4a4-15b2-47aa-a06f-4498fe2e05a3"
                    },
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/be98dc10-46df-415c-aae9-384746d5b635/wcs",
                        "name": "multispectral",
                        "type": "WCS",
                        "resourceId": "be98dc10-46df-415c-aae9-384746d5b635"
                    }
                ],
                "imagesWms": [
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/e754f4a4-15b2-47aa-a06f-4498fe2e05a3/wms",
                        "name": "panchromatic",
                        "type": "WMS",
                        "resourceId": "e754f4a4-15b2-47aa-a06f-4498fe2e05a3"
                    },
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/be98dc10-46df-415c-aae9-384746d5b635/wms",
                        "name": "multispectral",
                        "type": "WMS",
                        "resourceId": "be98dc10-46df-415c-aae9-384746d5b635"
                    }
                ],
                "imagesWmts": [
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/e754f4a4-15b2-47aa-a06f-4498fe2e05a3/wmts",
                        "name": "panchromatic",
                        "type": "WMTS",
                        "resourceId": "e754f4a4-15b2-47aa-a06f-4498fe2e05a3"
                    },
                    {
                        "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/images/be98dc10-46df-415c-aae9-384746d5b635/wmts",
                        "name": "multispectral",
                        "type": "WMTS",
                        "resourceId": "be98dc10-46df-415c-aae9-384746d5b635"
                    }
                ],
                "monitor": {
                    "href": "https://monitor.foundation.api.oneatlas.airbus.com/api/v1/activities/8553c339-2307-468e-8835-83df77cade22",
                    "name": "Monitor",
                    "type": "HTTP"
                },
                "quicklook": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/quicklook",
                    "name": "QuickLook",
                    "type": "HTTP"
                },
                "self": {
                    "href": "https://search.foundation.api.oneatlas.airbus.com/api/v1/opensearch?id=df4c27e2-ce70-4f3d-8928-5e27dfe12094",
                    "method": "GET",
                    "name": "self",
                    "resourceId": "df4c27e2-ce70-4f3d-8928-5e27dfe12094"
                },
                "thumbnail": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/thumbnail",
                    "name": "Thumbnail",
                    "type": "HTTP"
                },
                "wms": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/wms",
                    "name": "WMS",
                    "type": "WMS"
                },
                "wmts": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/df4c27e2-ce70-4f3d-8928-5e27dfe12094/wmts",
                    "name": "WMTS",
                    "type": "WMTS"
                }
            },
            "dataAccess": {
                "metadata": "http://daas.datastore.svc.cluster.local/packs/1f9bb79a-db3f-44af-a46d-d861ffbd8387",
                "packImages": [
                    {
                        "href": "http://daas.datastore.svc.cluster.local/images/be98dc10-46df-415c-aae9-384746d5b635",
                        "name": "multispectral",
                        "resourceId": "be98dc10-46df-415c-aae9-384746d5b635"
                    },
                    {
                        "href": "http://daas.datastore.svc.cluster.local/images/e754f4a4-15b2-47aa-a06f-4498fe2e05a3",
                        "name": "panchromatic",
                        "resourceId": "e754f4a4-15b2-47aa-a06f-4498fe2e05a3"
                    }
                ],
                "resourceId": "1f9bb79a-db3f-44af-a46d-d861ffbd8387"
            },
            "geometry": {
                "coordinates": [
                    [
                        [
                            86.1234443321,
                            42.3774685612
                        ],
                        [
                            86.123584467,
                            42.2457271923
                        ],
                        [
                            86.2827193226,
                            42.2448454382
                        ],
                        [
                            86.2829700326,
                            42.3768342801
                        ],
                        [
                            86.1234443321,
                            42.3774685612
                        ]
                    ]
                ],
                "type": "Polygon"
            },
            "properties": {
                "acquisitionDate": "2022-12-11T05:12:01.778Z",
                "acquisitionIdentifier": "ACQ_PNEO3_02329405139276",
                "acquisitionStation": "",
                "activityId": "8553c339-2307-468e-8835-83df77cade22",
                "archivingCenter": "",
                "azimuthAngle": 166.1560954655803,
                "cloudCover": 0,
                "commercialReference": "000060751",
                "constellation": "PNEO",
                "contractId": "<contract_id>",
                "correlationId": "PWOI_000060751_1_2_I_1",
                "customerReference": "<customer_reference>",
                "expirationDate": "2023-12-11T07:03:36Z",
                "format": "SAFIR",
                "geometryCentroid": {
                    "lat": 42.31116135046377,
                    "lon": 86.20320718234834
                },
                "id": "df4c27e2-ce70-4f3d-8928-5e27dfe12094",
                "illuminationAzimuthAngle": 166.036157103877,
                "illuminationElevationAngle": 23.572311147419587,
                "incidenceAngle": 9.919399980046554,
                "incidenceAngleAcrossTrack": 2.4177380903339203,
                "incidenceAngleAlongTrack": 9.648469436182321,
                "internalLine": "1_2",
                "internalReference": "SAL22051564",
                "lastUpdateDate": "2022-12-11T07:03:36Z",
                "organisationName": "",
                "platform": "PNEO3",
                "processingCenter": "",
                "processingDate": "2022-12-11T06:51:25.1Z",
                "processingLevel": "SENSOR",
                "processorName": "SPICYv1.2.9",
                "productCategory": "image",
                "productType": "bundle",
                "productionStatus": "IN_CLOUD",
                "publicationDate": "2022-12-11T06:59:37.910304059Z",
                "qualified": false,
                "resolution": 0.31,
                "sensorType": "OPTICAL",
                "sourceIdentifier": "PNEO3_20221211T063414_BUNDLE-FS_PRIMARY",
                "spectralRange": "VISIBLE",
                "workspaceId": "<workspaceId>",
                "workspaceName": "voicerose",
                "workspaceTitle": "voicerose"
            },
            "rights": {
                "browse": {
                    "privileges": [
                        {
                            "id": "114d4a2c-d9ca-4cb0-8051-356d9af5059d",
                            "filter": {
                                "workspaceId": "bbdaf4c9-37da-4480-9c52-c75cbfa17a22"
                            }
                        }
                    ]
                },
                "create": {
                    "privileges": [
                        {
                            "id": "19e0d6cc-85c7-4ffa-950c-c929b8025ec2",
                            "filter": {
                                "workspaceId": "bbdaf4c9-37da-4480-9c52-c75cbfa17a22"
                            }
                        }
                    ]
                },
                "delete": {
                    "privileges": [
                        {
                            "id": "114d4a2c-d9ca-4cb0-8051-356d9af5059d",
                            "filter": {
                                "workspaceId": "bbdaf4c9-37da-4480-9c52-c75cbfa17a22"
                            }
                        }
                    ]
                }
            },
            "type": "Feature"
        }
    ]
}

Track your orders

You can see all your orders thanks to this request:

API Endpointhttps://order.api.oneatlas.airbus.com/api/v2/orders/search
REST verbPOST
AuthenticationBearer access token

Request

{
    "paging": {
        "itemsPerPage": 25,
        "startIndex": 0,
        "pagingMode": "item"
    },
    "criteria": {
        "q": "(quotationStatus:ACCEPTED) AND (cis.quotation:QUO22054973) AND (contractId:CTR21000411) AND (status:IN_PROGRESS) AND (technicalProduct.source.id:tasking) AND (customerReference:*<customer_reference>*)"
    }
}


Some insight about the interesting keys to be used (not all keys are mandatory):

  • customerReference: is the reference you used when creating your order

  • quotationStatus: can be ACCEPTED (quotation has been accepted, order is running) or SENT(quotation not yet validated, order not yet running)

  • cis.quotation: id of the quotation can be used to search

  • contractId: id of the contract can be used to search

  • status: can be IN_PROGRESS (order is running) or DELIVERED (order finished, all data delivered) or CANCELLED (order cancelled)

  • technicalProduct.source.id: can be tasking or archive


Response

{
    "paging": {
        "itemsPerPage": 25,
        "startIndex": 0,
        "pagingMode": "item",
        "totalResults": 30
    },
    "features": [
        {
            "contractId": "<CisContractId>",
            "customerReference": "<customer_reference>",
            "quotationId": "QUO22006217",
            "salesOrderId": "SAL22005724",
            "program": "",
            "productType": "PleiadesNeoTaskingOnePlan",
            "licence": "standard",
            "aoi": {
                "name": "Polygon 1",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                -27.306937758050495,
                                38.72168083627531
                            ],
                            [
                                -27.1970744768005,
                                38.72168083627531
                            ],
                            [
                                -27.1970744768005,
                                38.81590473156177
                            ],
                            [
                                -27.306937758050495,
                                38.81590473156177
                            ],
                            [
                                -27.306937758050495,
                                38.72168083627531
                            ]
                        ]
                    ]
                }
            },
            "mission": "pleiadesneo",
            "source": "tasking",
            "target": "oneplan",
            "status": "CANCELLED",
            "comment": "",
            "tasking": {
                "holdBack": 0,
                "maxIncidenceAngle": 50.0,
                "acquisitionMode": "MONOSCOPIC",
                "cloudCoverageThresholdForProposition": 30.0,
                "period": [
                    {
                        "startDate": "2022-01-29T00:00:00Z",
                        "endDate": "2022-03-29T23:59:59Z"
                    }
                ],
                "taskingRequest": [
                    {
                        "taskingRequestId": "TWOI_000007805_1_N"
                    }
                ],
                "endOfInitialPeriod": "2022-03-29T23:59:59Z",
                "validatedArea": 0.0,
                "validatedAreaPct": 0.0,
                "receivingStationType": "vrs",
                "maxCloudCoverage": 10.0,
                "nbProposedCoverageItems": 0,
                "totalCoverageItems": 0
            },
            "processingLevel": "primary",
            "spectralProcessing": "full_bundle",
            "productFormat": "dimap_jpeg2000_regular",
            "pixelCoding": "12bits",
            "radiometricProcessing": "basic",
            "priority": "standard",
            "deliveryMethod": "on_the_flow",
            "deliveryAddress": "5 RUE DES SATELLITES   TOULOUSE CEDEX 4 31030 FR",
            "endUser": {
                "endUserCountryId": "CN"
            },
            "dumpingStation": [
                {
                    "processingStation": "FR1",
                    "receivingStation": "FR1"
                },
                {
                    "processingStation": "FR1",
                    "receivingStation": "IN1"
                },
                {
                    "processingStation": "FR1",
                    "receivingStation": "SE1"
                }
            ],
            "quotationStatus": "ACCEPTED",
            "quotationCreationDate": "2022-01-27T18:08:52Z",
            "orderCreationDate": "2022-01-27T18:09:08Z",
            "orderLineAmount": 0.0,
            "customerName": "[LE] Airbus DS Geo SA France",
            "contact": "john.doe@company.com",
            "orderLineAmountWithoutDiscount": 0.0,
            "currency": "EUR",
            "orderLineAmountDiscountPct": 0.0,
            "orderLineAmountWithDiscount": 0.0,
            "priceCalculationArea": 100.0,
            "orderMinimumApplied": true,
            "feasibilityStudyResult": {
                "coverRate": 0.0,
                "commitment": true
            },
            "customerId": "AC002902",
            "producedArea": 0.0,
            "deliveryType": "network",
            "deliveryPlatformId": "PublicMOC",
            "deliveryWorkspace": "bbdaf4c9-37da-4480-9c52-c75cbfa17a22",
            "requestedArea": 99.7919052906175,
            "notifications": [...],
            "projectionCode": "32626",
            "quotationEndOfValidityDate": "2022-01-28T00:00:00Z",
            "initialOrderLineAmountWithoutDiscount": 5000.0,
            "initialOrderLineAmountDiscountPct": 0.0,
            "initialOrderLineAmountWithDiscount": 5000.0,
            "initialPriceCalculationArea": 100.0,
            "cancelationDeadlineDate": "2022-01-28T00:00:00Z",
            "producedAreaPct": 0.0,
            "productionRoute": "GDSIP3",
            "quotationVersion": 1,
            "orderLineDescription": "Pléiades Neo Tasking OnePlan 100 km2    basic",
            "onePlanPro": true,
            "orderItemId": "WOI_000007805_1",
            "lastStatusChangeDate": "2022-01-27T20:21:21Z",
            "orderCreator": "5247773080",
            "orderLineId": 1
        }
    ]
}

Stereo and tristereo specificities

  • STEREO and TRISTEREO options are available for all tasking offers (OneDay, OneNow, OnePlan)
  • STEREO and TRISTEREO can only be requested through a quotation process (because it requires manual feasibility).
  • In the request payload, within items/properties:
    • acquisitionMode can be set to “STEREO” or “TRISTEREO”
    • the key “acquisitionModeMinBH” must be present and its value set as a string between “0.2” and “0.8”
    • the key “acquisitionModeMaxBH” must be present and its value set as a string between “0.2” and “0.8”
  • Production parameters are limited:
    • processing_level : “primary”
    • spectral_processing : “full_bundle”
    • image_format : “dimap_jpeg2000_regular” or “dimap_geotiff”
    • pixel_coding: “12bits”
    • radiometric_processing: “reflectance”

bh-details


Request example (to the quotation endpoint)

{
  "aoi": [
    {
      "id": 1,
      "name": "Polygon 1",
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -42.49931262834877,
              20.92430224367932
            ],
            [
              -42.40303112165122,
              20.92430224367932
            ],
            [
              -42.403059936210546,
              20.834370239032097
            ],
            [
              -42.499283813789454,
              20.834370239032097
            ],
            [
              -42.49931262834877,
              20.92430224367932
            ]
          ]
        ]
      }
    }
  ],
  "contractId": "<CisContractId>",
  "items": [
    {
      "productTypeId": "PleiadesNeoTaskingOneDay",
      "aoiId": 1,
      "properties": [
        {
          "key": "acqPeriod",
          "value": "2023-12-14T13:29:57.299Z 2023-12-14T13:29:59.073Z"
        },
        {
          "key": "comments",
          "value": "This is my personal comment"
        },
        {
          "key": "feasibilityAutomation",
          "value": "MANUAL"
        },
        {
          "key": "acquisitionMode",
          "value": "TRISTEREO"
        },
        {
          "key": "acquisitionModeMinBH",
          "value": "0.2"
        },
        {
          "key": "acquisitionModeMaxBH",
          "value": "0.8"
        },
        {
          "key": "maxIncidenceAngle",
          "value": 50
        }
      ],
      "holdback": false
    }
  ],
  "customerReference": "My chosen ref for this tristereo order",
  "optionsPerProductType": [
    {
      "productTypeId": "PleiadesNeoTaskingOneDay",
      "options": [
        {
          "key": "spectral_processing",
          "value": "full_bundle"
        },
        {
          "key": "radiometric_processing",
          "value": "reflectance"
        },
        {
          "key": "image_format",
          "value": "dimap_jpeg2000_regular"
        },
        {
          "key": "pixel_coding",
          "value": "12bits"
        },
        {
          "key": "processing_level",
          "value": "primary"
        },
        {
          "key": "licence",
          "value": "standard"
        },
        {
          "key": "delivery_method",
          "value": "on_the_flow"
        }
      ]
    }
  ],
  "endUsers": [
    {
      "endUserName": "John Doe",
      "country": "FR"
    }
  ]
}

Retrieve acquisitions on an order

Note: Pléiades and SPOT are working at segment level while Pléiades Neo at coverage item (1 coverage item is by default a scene equivalent)

You can retrieve coverage items using:

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/coverages/search
REST verbPOST
AuthenticationBearer access token

Request

{
    "paging": {
        "itemsPerPage": 10000,
        "startIndex": 0
    },
    "criteria": {
        "q": "(orderItemId:WOI_000016433_1 AND contractId:CTR21000438) AND (status:VALIDATED OR status:PROPOSED OR status:REFUSED OR status:PENDING OR status:REJECTED)"
    }
}


Status of a coverage item can be:

  • VALIDATED: the coverage item fits initial automatic acceptance criteria

  • PROPOSED: the coverage item fits initial manual acceptance criteria - requires action from the user to accept / refuse (see dedicated chapter)

  • REFUSED: the coverage item has been proposed by the system then refused by the user

  • PENDING: the coverage item is in a temporary state managed by the system - no user actions expected

  • REJECTED: the coverage item has been refused by the system based on the acceptance criteria provided by the user


Response

{
    "paging": {
        "itemsPerPage": 10000,
        "startIndex": 0,
        "totalResults": 16
    },
    "features": [
        {
            "contractId": "CTR21000438",
            "coverageItemId": "CIE_000016433_1_11_1",
            "orderItemId": "WOI_000016433_1",
            "status": "VALIDATED",
            "clearSkyRate": 99.4,
            "catalogPlatformId": "MMCAT",
            "archiveId": "ACQ_PNEO4_01329602026817",
            "satellite": "PNEO4",
            "mission": "pleiadesneo",
            "alongTrackIncidenceAngle": 39.27327464777751,
            "orthoTrackIncidenceAngle": 13.193668831466903,
            "orientation": 0.0,
            "incidenceAngle": 39.693666644420055,
            "sunAzimuth": 41.138672060176276,
            "sunElevation": 40.490731096057644,
            "psiX": -15.897489790827025,
            "psiY": -33.34556509252087,
            "psiXY": 35.64087046215445,
            "bh": 0.0,
            "customerId": "AC002902",
            "quotationId": "QUO22014076",
            "salesOrderId": "SAL22013111",
            "footprint": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            18.4256442,
                            -34.09739311
                        ],
                        [
                            18.37668271,
                            -34.09290259
                        ],
                        [
                            18.32775794,
                            -34.08837245
                        ],
                        [
                            18.27873561,
                            -34.08379012
                        ],
                        [
                            18.27852709,
                            -33.87722682
                        ],
                        [
                            18.42631714,
                            -33.89147992
                        ],
                        [
                            18.42617671,
                            -33.94354314
                        ],
                        [
                            18.42601553,
                            -33.99427141
                        ],
                        [
                            18.42601124,
                            -33.9955442
                        ],
                        [
                            18.42583424,
                            -34.04593298
                        ],
                        [
                            18.4256442,
                            -34.09739311
                        ]
                    ]
                ]
            },
            "acquisitionDate": "2022-04-08T08:48:08.02Z"
        },
        {...}
      ]
}

Export the coverage item id coverageItemId

Accept or refuse an acquisition

Note: Pléiades and SPOT are working at segment level while Pléiades Neo at coverage item (1 coverage item is by default a scene equivalent)

In case you get acquisitions that are above the automatic acceptance threshold and under the notification threshold, you will have to validate or refuse the acquisition.

coverageItemId to be validated or refused are with the status PROPOSED using Retrieve acquisitions on an order.


You can then accept an acquisition using:

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/coverages/<coverageItemId>/accept
REST verbPOST
AuthenticationBearer access token

You can refuse a acquisition using:

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/coverages/<coverageItemId>/refuse
REST verbPOST
AuthenticationBearer access token

Cancel a tasking order

You have the possibility to cancel the tasking until 12 hours before the start of your tasking window using:

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/orders/<orderItemId>/cancel
REST verbPOST
AuthenticationBearer access token

orderItemId information can be retrieved from Track your orders

Stop a tasking order

You have the possibility to stop the tasking after 12 hours before the start of your tasking window using:

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/orders/<orderItemId>/stop
REST verbPOST
AuthenticationBearer access token

orderItemId information can be retrieved from Track your orders

Note: Acquisitions already done - and within acceptance criteria - will be invoiced

Manage quotations

You can get access quotations using the following request. The customer reference is the personal reference you defined when sending the quotation request.

API Endpointhttps://order.api.oneatlas.airbus.com/api/v2/orders/search
REST verbPOST
AuthenticationBearer access token

Request

{
    "paging": {
        "itemsPerPage": 25,
        "startIndex": 0,
        "pagingMode": "item"
    },
    "criteria": {
        "q": "(customerReference:*<customer_reference>*) AND (quotationStatus:SENT) AND (contractId:<CisContractId>)"
    }
}

Retrieve quotationId then

To accept a quotation:

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/contracts/<CisContractId>/quotations/<quotationId>/accept
REST verbPUT
AuthenticationBearer access token


Once accepted, the order is automatically created.

To refuse a quotation:

API Endpointhttps://order.api.oneatlas.airbus.com/api/v1/contracts/<CisContractId>/quotations/<quotationId>/refuse
REST verbPUT
AuthenticationBearer access token

Request

{"rejectionReasonId":1}
Contact Us