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.
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
{“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
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.
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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/feasibility |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/attempts |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/prices |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/quotations |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/orders |
| REST verb | POST |
| Authentication | Bearer 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:
productTypeIdcan be retrieved using Get product typesPlease refer to the dedicated Get production options for processing options
classificationandfeasibilityAutomationare the results of the feasibility study step.customerReferencecan 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 orderNotification 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,
notificationThresholdandmaxCloudCoverwill not be considered and forced to 100%Dem and projection are not mandatory for primary, Dem is not mandatory for projected
The
QUOidsent back in the response can be used to search for your order
About multi-item and multi-aoi orders:
The number
aoiIdcorresponds to both theidof theaoiThe number
1indem_1andprojection_1refers to both theaoiId
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 Endpoint | https://search.foundation.api.oneatlas.airbus.com/api/v2/opensearch |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v2/orders/search |
| REST verb | POST |
| Authentication | Bearer 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) orSENT(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) orDELIVERED(order finished, all data delivered) orCANCELLED(order cancelled)technicalProduct.source.id: can be
taskingorarchive
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”
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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/coverages/search |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/coverages/<coverageItemId>/accept |
| REST verb | POST |
| Authentication | Bearer access token |
You can refuse a acquisition using:
| API Endpoint | https://order.api.oneatlas.airbus.com/api/v1/coverages/<coverageItemId>/refuse |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/orders/<orderItemId>/cancel |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/orders/<orderItemId>/stop |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v2/orders/search |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/contracts/<CisContractId>/quotations/<quotationId>/accept |
| REST verb | PUT |
| Authentication | Bearer access token |
Once accepted, the order is automatically created.
To refuse a quotation:
| API Endpoint | https://order.api.oneatlas.airbus.com/api/v1/contracts/<CisContractId>/quotations/<quotationId>/refuse |
| REST verb | PUT |
| Authentication | Bearer access token |
Request
{"rejectionReasonId":1}
© Airbus Defence and Space 2022. All rights reserved. Privacy Policy | Legal Information