Language

Detailed step-by-step explanations for Pléiades and SPOT archive

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: Browse archives

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

Request

{
    "itemsPerPage": 10,
    "startPage": 1,
    "workspace": "public"
}

Our search API supports following criteria:

  • acquisitionDate

  • cloudCover

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

  • incidenceAngle

  • geometry in geojson

Our search API supports sorting items using cloudCover and dates (acquisitionDate and lastUpdateDate)



Each image is returned as a GeoJSON feature under the /features[] property.

  • id of the acquisition will be used for ordering under catalogItemId

  • archiveIdentifier of the acquisition will be used for ordering under datastripIds

  • Cloud cover is calculated at acquisition level, not re-calculated at the Area of Interest

  • Most of the ‘links’ are not enabled / useful in case of an ALBUM, only quicklook and thumbnail can be used

Response

{
            "_links": {
                "delete": {
                    "href": "https://search.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598",
                    "name": "Delete",
                    "type": "HTTP"
                },
                "imagesGetBuffer": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/images/02b74765-2851-4a7f-a1e0-dddf0da6c77d/buffer",
                    "type": "getBuffer",
                    "resourceId": "02b74765-2851-4a7f-a1e0-dddf0da6c77d"
                },
                "imagesMetadata": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/images/02b74765-2851-4a7f-a1e0-dddf0da6c77d/metadata",
                    "type": "application/geo+json",
                    "resourceId": "02b74765-2851-4a7f-a1e0-dddf0da6c77d"
                },
                "imagesWcs": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/images/02b74765-2851-4a7f-a1e0-dddf0da6c77d/wcs",
                    "type": "WCS",
                    "resourceId": "02b74765-2851-4a7f-a1e0-dddf0da6c77d"
                },
                "imagesWms": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/images/02b74765-2851-4a7f-a1e0-dddf0da6c77d/wms",
                    "type": "WMS",
                    "resourceId": "02b74765-2851-4a7f-a1e0-dddf0da6c77d"
                },
                "imagesWmts": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/images/02b74765-2851-4a7f-a1e0-dddf0da6c77d/wmts",
                    "type": "WMTS",
                    "resourceId": "02b74765-2851-4a7f-a1e0-dddf0da6c77d"
                },
                "monitor": {
                    "href": "https://monitor.foundation.api.oneatlas.airbus.com/api/v1/activities/5812b594-b0a4-4c0c-8b2f-81be317260ab",
                    "name": "Monitor",
                    "type": "HTTP"
                },
                "quicklook": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/quicklook",
                    "name": "QuickLook",
                    "type": "HTTP"
                },
                "self": {
                    "href": "https://search.foundation.api.oneatlas.airbus.com/api/v1/opensearch?id=dd2595dd-30c8-455a-aeb0-bf1237dee598",
                    "method": "GET",
                    "name": "self",
                    "resourceId": "dd2595dd-30c8-455a-aeb0-bf1237dee598"
                },
                "thumbnail": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/thumbnail",
                    "name": "Thumbnail",
                    "type": "HTTP"
                },
                "wms": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/wms",
                    "name": "WMS",
                    "type": "WMS"
                },
                "wmts": {
                    "href": "https://access.foundation.api.oneatlas.airbus.com/api/v1/items/dd2595dd-30c8-455a-aeb0-bf1237dee598/wmts",
                    "name": "WMTS",
                    "type": "WMTS"
                }
            },
            "dataAccess": {
                "metadata": "http://datastore-vaas/api/v1/genericProduct/packs/b76807f3-fe0d-46e4-a5f9-ba50b5b26db2",
                "packImages": [
                    {
                        "href": "http://datastore-vaas/api/v1/packs/b76807f3-fe0d-46e4-a5f9-ba50b5b26db2/images/02b74765-2851-4a7f-a1e0-dddf0da6c77d",
                        "resourceId": "02b74765-2851-4a7f-a1e0-dddf0da6c77d"
                    }
                ],
                "resourceId": "b76807f3-fe0d-46e4-a5f9-ba50b5b26db2"
            },
            "geometry": {
                "coordinates": [
                    [
                        [
                            30.740695196903708,
                            -4.321588471756338
                        ],
                        [
                            30.740967878619724,
                            -4.861535568978129
                        ],
                        [
                            31.28873207425321,
                            -4.862845799994113
                        ],
                        [
                            31.288560248359172,
                            -4.324837694170229
                        ],
                        [
                            30.740695196903708,
                            -4.321588471756338
                        ]
                    ]
                ],
                "type": "Polygon"
            },
            "properties": {
                "acquisitionDate": "2022-12-16T07:50:55.374Z",
                "acquisitionIdentifier": "",
                "acquisitionStation": "FR1",
                "activityId": "5812b594-b0a4-4c0c-8b2f-81be317260ab",
                "archiveAnonymousIdentifier": "33319020",
                "archiveIdentifier": "DS_SPOT7_202212160750554_FR1_FR1_FR1_FR1_E031S05_01871",
                "archivingCenter": "FR1",
                "azimuthAngle": 180.0051933880859,
                "cloudCover": 29.68648867313916,
                "constellation": "SPOT",
                "correlationId": "88973dac-2c02-4bc7-922d-fd93f20fe1aa",
                "expirationDate": "2032-12-13T09:42:08.030447178Z",
                "format": "image/tiff",
                "geometryCentroid": {
                    "lat": -4.592235202687462,
                    "lon": 31.01471363557897
                },
                "id": "dd2595dd-30c8-455a-aeb0-bf1237dee598",
                "illuminationAzimuthAngle": 125.57112833984492,
                "illuminationElevationAngle": 55.725698378409675,
                "incidenceAngle": 9.640486239375852,
                "incidenceAngleAcrossTrack": 0.8406726517679302,
                "incidenceAngleAlongTrack": 9.611188225328718,
                "lastUpdateDate": "2022-12-16T09:42:47.239952514Z",
                "organisationName": "AIRBUS DS GEO",
                "parentIdentifier": "DS_SPOT7_202212160750554_FR1_FR1_FR1_FR1_E031S05_01871",
                "platform": "SPOT7",
                "processingCenter": "MOC",
                "processingDate": "2022-12-16T09:38:25.008Z",
                "processingLevel": "ALBUM",
                "processorName": "MMCAT",
                "productCategory": "image",
                "productType": "mono",
                "productionStatus": "ARCHIVED",
                "publicationDate": "2022-12-16T09:42:47.239952514Z",
                "qualified": false,
                "resolution": 1.5,
                "sensorType": "OPTICAL",
                "snowCover": 0,
                "sourceIdentifier": "DS_SPOT7_202212160750554_FR1_FR1_FR1_FR1_E031S05_01871",
                "spectralRange": "VISIBLE",
                "title": "",
                "workspaceId": "0e33eb50-3404-48ad-b835-b0b4b72a5625",
                "workspaceName": "public",
                "workspaceTitle": "Public"
            },
            "rights": {
                "browse": {
                    "privileges": [
                        {
                            "id": "115b0732-c2ec-499b-b2b3-63b8043c4a43",
                            "subscriptionId": "60166425-86af-44ef-81b4-c626d5d46244",
                            "filter": {
                                "workspaceId": "0e33eb50-3404-48ad-b835-b0b4b72a5625"
                            }
                        }
                    ]
                },
                "wms": {
                    "privileges": [
                        {
                            "id": "81095c53-daaf-4c56-800d-094726cffae1",
                            "subscriptionId": "7e873a85-86e1-49c0-a5b0-1966c8f207ad",
                            "filter": {
                                "workspaceId": "0e33eb50-3404-48ad-b835-b0b4b72a5625"
                            }
                        }
                    ]
                },
                "wmts": {
                    "privileges": [
                        {
                            "id": "81095c53-daaf-4c56-800d-094726cffae1",
                            "subscriptionId": "7e873a85-86e1-49c0-a5b0-1966c8f207ad",
                            "filter": {
                                "workspaceId": "0e33eb50-3404-48ad-b835-b0b4b72a5625"
                            }
                        }
                    ]
                }
            },
            "type": "Feature"
        }

Step 3: Calculate Price

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

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

Step 4: Request a quotation

Note: This feature is only available for Pléiades Neo.

Step 5: Create an order

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

catalogItemId to be used in the payload is to be retrieved from the result of Search under the key id

Body request sample Pléiades Archive

{
    "aoi": [
        {
            "id": 1,
            "name": "Polygon 1",
            "geometry": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            1.4125259575195295,
                            43.586101687094356
                        ],
                        [
                            1.464024370605467,
                            43.586101687094356
                        ],
                        [
                            1.464024370605467,
                            43.623143915843656
                        ],
                        [
                            1.4125259575195295,
                            43.623143915843656
                        ],
                        [
                            1.4125259575195295,
                            43.586101687094356
                        ]
                    ]
                ]
            }
        }
    ],
    "programReference": "",
    "contractId": "Test_E2E_BR_1392-1375",
    "items": [
        {
            "notifications": [
                {
                    "name": "",
                    "channels": [
                        {
                            "parameters": {
                                "addresses": [
                                    "john.doe@company.com"
                                ]
                            },
                            "type": "email"
                        }
                    ],
                    "filter": {
                        "events": []
                    }
                }
            ],
            "stations": [],
            "productTypeId": "PleiadesArchiveMono",
            "dataSourceIds": [
                {
                    "catalogId": "PublicMOC",
                    "catalogItemId": "bd6ce7ac-403c-4a9c-8833-9a6001bd664d"
                }
            ],
            "datastripIds": [
                "DS_PHR1A_202212111112398_FR1_PX_E001N43_0615_01665"
            ],
            "aoiId": 1,
            "properties": [],
            "segmentKey": "bd6ce7ac-403c-4a9c-8833-9a6001bd664d"
        }
    ],
    "primaryMarket": "NQUAL",
    "secondaryMarket": "",
    "customerReference": "Polygon 1",
    "optionsPerProductType": [
        {
            "productTypeId": "PleiadesArchiveMono",
            "options": [
                {
                    "key": "spectral_processing",
                    "value": "pansharpened_natural_color"
                },
                {
                    "key": "radiometric_processing",
                    "value": "basic"
                },
                {
                    "key": "image_format",
                    "value": "dimap_jpeg2000_regular"
                },
                {
                    "key": "pixel_coding",
                    "value": "12bits"
                },
                {
                    "key": "processing_level",
                    "value": "primary"
                },
                {
                    "key": "priority",
                    "value": "standard"
                },
                {
                    "key": "licence",
                    "value": "standard"
                }
            ]
        }
    ],
    "orderGroup": "",
    "endUsers": [
        {}
    ],
    "delivery": {
        "type": "network",
        "workspace": "1a7aaef1-839e-4eaa-826c-aabee39eac85",
        "platformId": "PublicMOC"
    },
    "notificationEmails": [
        "john.doe@company.com"
    ]
}

Response

{
    "salesOrderId": "SAL21416909",
    "currency": "EUR",
    "discountPercentage": 0.0,
    "discountValue": 0.0,
    "totalAmount": 250.0
}

Notes:

  • productTypeId can be retrieved using Get product types

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

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


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 6: 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

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

Note: This feature is only available for Pléiades Neo.

Manage quotations

Note: This feature is only available for Pléiades Neo.

Contact Us