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 Endpoint | https://search.foundation.api.oneatlas.airbus.com/api/v2/opensearch |
| REST verb | POST |
| Authentication | Bearer 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.
idof the acquisition will be used for ordering undercatalogItemIdarchiveIdentifierof the acquisition will be used for ordering underdatastripIdsCloud 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/prices |
| REST verb | POST |
| Authentication | Bearer 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 Endpoint | https://order.api.oneatlas.airbus.com/api/v1/orders |
| REST verb | POST |
| Authentication | Bearer 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:
productTypeIdcan be retrieved using Get product typesPlease 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
aoiIdcorresponds to both theidof theaoiThe number
1indem_1andprojection_1refers to both theaoiId
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 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
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.
© Airbus Defence and Space 2022. All rights reserved. Privacy Policy | Legal Information
Contact Us