Language
ONEATLAS DATA GUIDE
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.
id
of the acquisition will be used for ordering undercatalogItemId
archiveIdentifier
of the acquisition will be used for ordering underdatastripIds
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 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": [
"kevin.maveau@airbus.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": [
"kevin.maveau@airbus.com"
]
}
Response
{
"salesOrderId": "SAL21416909",
"currency": "EUR",
"discountPercentage": 0.0,
"discountValue": 0.0,
"totalAmount": 250.0
}
Notes:
productTypeId
can 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
aoiId
corresponds to both theid
of theaoi
The number
1
indem_1
andprojection_1
refers 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