Language
OneAtlas Data Guide
  1. Order an Individual Product
    1. Calculate Price for an Individual Product
    2. Place an Order for an Individual Product
    3. View Order Status

Order an Individual Product

Ordering an individual product will provide you a chance to select an OneAtlas data Living Library image, clip it to your AOI, process it using your custom parameters and get delivered in your workspace. Once delivered, you will be able to download or stream the resulting product.

Note: When ordering a product your AOI must be between 0.1km² and 400km² for PHR (Pleiades) products or between 0.1km² and 3600km² for SPOT products.

When retrieving the price or ordering a product there will be parameters that you need to specify for the API to calculate the correct price. The same parameters will need to be specified when you place your order. This section will guide you through the available parameters for our Ordering API.


In addition, there are other production options that must be specified are the image format of the output product and its projection. These parameters are mandatory to process the product, but do not influence the price calculation.


Two images formats are currently available:

Image FormatDescription
image/jp2The format of the delivered image will be JPEG 2000
image/geotiffThe format of the delivered image will be Cloud Optimized Geotiff

Multiple EPSG’s are available:

Image FormatDescription
EPSG:4326Geodetic coordinate system for World using Uses simple Equirectangular projection
EPSG:326[01-60]WGS 84 north zones
EPSG:327[01-60]WGS 84 south zones

Two radiometric processing types are available:

Radiometric ProcessingDescription
REFLECTANCESensor calibration and systematic atmospheric effects are effectivley used to radiometrically correct the image.
DISPLAYFormer OVR (Optimized Visual Rendering). 8-bit pixel coding is requested which appears lighter.

Calculate Price for an Individual Product

When calculating the price of an individual product you must specify certain parameters. The JSON structure to provide has the form:

{
  "kind": "order.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "ce4a073e-915a-4e15-b943-4470e02e0511",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -109.75650787353511,
              37.18739913717396
            ],
            [
              -109.71754074096678,
              37.18739913717396
            ],
            [
              -109.71754074096678,
              37.22349415461226
            ],
            [
              -109.75650787353516,
              37.22349415461226
            ],
            [
              -109.75650787353516,
              37.18739913717396
            ]

          ]
        ]
      }
    }
  ]
}

To calculate the price of a product the following endpoint must be used:

API Endpoint/api/v1/prices
REST verbPOST
AuthenticationJWT Token
API ReferenceOrder API

Below is an example of a call:

curl -X POST \
  https://data.api.oneatlas.airbus.com/api/v1/prices \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -d '{ "kind": "order.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "db234757-415e-45ea-91fe-b4a3430d9262",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
              [
                        [
                            133.0892544400306,
                            -25.87101100509336
                        ],
                        [
                            133.1536981096795,
                            -25.87132836142507
                        ],
                        [
                            133.153641115244,
                            -25.92385213283325
                        ],
                        [
                            133.0892077568722,
                            -25.92358780411442
                        ],
                        [
                            133.0892544400306,
                            -25.87101100509336
                        ]

          ]
        ]
      }
    }
  ]

  }'
var data = JSON.stringify({
  "kind": "order.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "db234757-415e-45ea-91fe-b4a3430d9262",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              133.0892544400306,
              -25.87101100509336
            ],
            [
              133.1536981096795,
              -25.87132836142507
            ],
            [
              133.153641115244,
              -25.92385213283325
            ],
            [
              133.0892077568722,
              -25.92358780411442
            ],
            [
              133.0892544400306,
              -25.87101100509336
            ]
          ]
        ]
      }
    }
  ]
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://data.api.oneatlas.airbus.com/api/v1/prices");
xhr.setRequestHeader("Authorization", "Bearer <access_token>");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);
import requests

url = "https://data.api.oneatlas.airbus.com/api/v1/prices"

payload = "{ \"kind\": \"order.product\",\n  \"products\": [\n    {\n      \"productType\": \"bundle\",\n      \"radiometricProcessing\": \"REFLECTANCE\",\n      \"imageFormat\": \"image/jp2\",\n      \"crsCode\": \"urn:ogc:def:crs:EPSG::4326\",\n      \"id\": \"db234757-415e-45ea-91fe-b4a3430d9262\",\n      \"aoi\": {\n        \"type\": \"Polygon\",\n        \"coordinates\": [\n              [\n                        [\n                            133.0892544400306,\n                            -25.87101100509336\n                        ],\n                        [\n                            133.1536981096795,\n                            -25.87132836142507\n                        ],\n                        [\n                            133.153641115244,\n                            -25.92385213283325\n                        ],\n                        [\n                            133.0892077568722,\n                            -25.92358780411442\n                        ],\n                        [\n                            133.0892544400306,\n                            -25.87101100509336\n                        ]\n\n          ]\n        ]\n      }\n    }\n  ]\n\n  }"
headers = {
    'Authorization': "Bearer <access_token>",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Note: Your kindmust be order.data.gb.productif you have a GB subscription or order.productif you have a tiles subscription.

Here is a snippet of the response showing the price:

{
    "payload": {
        "kind": "order.product",
        "products": [
            {
                "productType": "bundle",
                "radiometricProcessing": "REFLECTANCE",
                "imageFormat": "image/jp2",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "db234757-415e-45ea-91fe-b4a3430d9262",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                133.0892544400306,
                                -25.87101100509336
                            ],
                            [
                                133.1536981096795,
                                -25.87132836142507
                            ],
                            [
                                133.153641115244,
                                -25.92385213283325
                            ],
                            [
                                133.0892077568722,
                                -25.92358780411442
                            ],
                            [
                                133.0892544400306,
                                -25.87101100509336
                            ]
                        ]
                    ]
                }
            }
        ]
    },
    "deliveries": [
        {
            "datas": {
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                133.0892544400306,
                                -25.87101100509336
                            ],
                            [
                                133.1536981096795,
                                -25.87132836142507
                            ],
                            [
                                133.153641115244,
                                -25.92385213283325
                            ],
                            [
                                133.0892077568722,
                                -25.92358780411442
                            ],
                            [
                                133.0892544400306,
                                -25.87101100509336
                            ]
                        ]
                    ]
                },
                "productType": "bundle",
                "radiometricProcessing": "REFLECTANCE",
                "imageFormat": "image/jp2",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "db234757-415e-45ea-91fe-b4a3430d9262",
                "sourceId": "DS_PHR1B_201801080119199_FR1_PX_E133S26_0203_00541"
            },
            "id": "db234757-415e-45ea-91fe-b4a3430d9262",
            "price": 377,
            "areaKm2": 37.75
        }
    ],
    "price": {
        "credits": 377,
        "areaKm2": 37.75
    },
    "feasibility": "automatic",
    "orderable": "ok"
}

The response provides information regarding the number of credits that will be decrease from the customer account when the order will be placed.

Place an Order for an Individual Product

Once you calculated the price of an individual product, you can place the order for true. If you are ready to proceed, then the following endpoint must be used:

API Endpoint/api/v1/orders
REST verbPOST
AuthenticationJWT Token
API ReferenceOrder API

The JSON structure to use is equivalent to the structure used to calculate the price:

{
  "kind": "order.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "xxxxxxxx-wwww-yyyy-vvvv-zzzzzzzzzzzz",
      "aoi": {
        ...
      }
    }
  ]
}

Below is an example of a call:

curl -X POST \
  https://data.api.oneatlas.airbus.com/api/v1/orders \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -d '{ "kind": "order.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "db234757-415e-45ea-91fe-b4a3430d9262",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
                        [
                            133.0892544400306,
                            -25.87101100509336
                        ],
                        [
                            133.1536981096795,
                            -25.87132836142507
                        ],
                        [
                            133.153641115244,
                            -25.92385213283325
                        ],
                        [
                            133.0892077568722,
                            -25.92358780411442
                        ],
                        [
                            133.0892544400306,
                            -25.87101100509336
                        ]

          ]
        ]
      }
    }
  ]

  }'
var data = JSON.stringify({
  "kind": "order.product",
  "products": [
    {
      "productType": "bundle",
      "radiometricProcessing": "REFLECTANCE",
      "imageFormat": "image/jp2",
      "crsCode": "urn:ogc:def:crs:EPSG::4326",
      "id": "db234757-415e-45ea-91fe-b4a3430d9262",
      "aoi": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              133.0892544400306,
              -25.87101100509336
            ],
            [
              133.1536981096795,
              -25.87132836142507
            ],
            [
              133.153641115244,
              -25.92385213283325
            ],
            [
              133.0892077568722,
              -25.92358780411442
            ],
            [
              133.0892544400306,
              -25.87101100509336
            ]
          ]
        ]
      }
    }
  ]
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://data.api.oneatlas.airbus.com/api/v1/orders");
xhr.setRequestHeader("Authorization", "Bearer <access_token>");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);
import requests

url = "https://data.api.oneatlas.airbus.com/api/v1/orders"

payload = "{ \"kind\": \"order.product\",\n  \"products\": [\n    {\n      \"productType\": \"bundle\",\n      \"radiometricProcessing\": \"REFLECTANCE\",\n      \"imageFormat\": \"image/jp2\",\n      \"crsCode\": \"urn:ogc:def:crs:EPSG::4326\",\n      \"id\": \"db234757-415e-45ea-91fe-b4a3430d9262\",\n      \"aoi\": {\n        \"type\": \"Polygon\",\n        \"coordinates\": [\n          [\n                        [\n                            133.0892544400306,\n                            -25.87101100509336\n                        ],\n                        [\n                            133.1536981096795,\n                            -25.87132836142507\n                        ],\n                        [\n                            133.153641115244,\n                            -25.92385213283325\n                        ],\n                        [\n                            133.0892077568722,\n                            -25.92358780411442\n                        ],\n                        [\n                            133.0892544400306,\n                            -25.87101100509336\n                        ]\n\n          ]\n        ]\n      }\n    }\n  ]\n\n  }"
headers = {
    'Authorization': "Bearer <access_token>",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Note: Your kindmust be order.data.gb.productif you have a GB subscription or order.productif you have a tiles subscription.

Here you can see the initial response with status ordered.

{
    "_links": {
        "self": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/52e92c4c-6ae7-49f5-bb30-c0e6dc2bd3f7"
        },
        "contract": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/5349b24f-eed4-44f6-a98b-d9ddd88e4cab"
        },
        "payments": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/52e92c4c-6ae7-49f5-bb30-c0e6dc2bd3f7/payments"
        }
    },
    "id": "52e92c4c-6ae7-49f5-bb30-c0e6dc2bd3f7",
    "kind": "order.product",
    "createdAt": "2018-12-03T16:26:12.119065+00:00",
    "createdBy": "75e0cc0b-bece-47bb-fa1c-0644d3fe3cf6",
    "status": "ordered",
    "contractId": "5349b24f-eed4-44f6-a98b-d9ddd88e4cab",
    "price": 377,
    "payload": {
        "kind": "order.product",
        "products": [
            {
                "productType": "bundle",
                "radiometricProcessing": "REFLECTANCE",
                "imageFormat": "image/jp2",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "db234757-415e-45ea-91fe-b4a3430d9262",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                133.0892544400306,
                                -25.87101100509336
                            ],
                            [
                                133.1536981096795,
                                -25.87132836142507
                            ],
                            [
                                133.153641115244,
                                -25.92385213283325
                            ],
                            [
                                133.0892077568722,
                                -25.92358780411442
                            ],
                            [
                                133.0892544400306,
                                -25.87101100509336
                            ]
                        ]
                    ]
                }
            }
        ]
    }
}

Within a few minutes your status will changed from ordered to delivered. You can see an example of the ordered product result below:

{
    "_links": {
        "self": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/52e92c4c-6ae7-49f5-bb30-c0e6dc2bd3f7"
        },
        "contract": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/5349b24f-eed4-44f6-a98b-d9ddd88e4cab"
        },
        "payments": {
            "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/52e92c4c-6ae7-49f5-bb30-c0e6dc2bd3f7/payments"
        }
    },
    "id": "52e92c4c-6ae7-49f5-bb30-c0e6dc2bd3f7",
    "kind": "order.product",
    "createdAt": "2018-12-03T16:26:12.119065+00:00",
    "createdBy": "75e0cc0b-bece-47bb-fa1c-0644d3fe3cf6",
    "status": "delivered",
    "contractId": "5349b24f-eed4-44f6-a98b-d9ddd88e4cab",
    "price": 377,
    "payload": {
        "kind": "order.product",
        "products": [
            {
                "productType": "bundle",
                "radiometricProcessing": "REFLECTANCE",
                "imageFormat": "image/jp2",
                "crsCode": "urn:ogc:def:crs:EPSG::4326",
                "id": "db234757-415e-45ea-91fe-b4a3430d9262",
                "aoi": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                133.0892544400306,
                                -25.87101100509336
                            ],
                            [
                                133.1536981096795,
                                -25.87132836142507
                            ],
                            [
                                133.153641115244,
                                -25.92385213283325
                            ],
                            [
                                133.0892077568722,
                                -25.92358780411442
                            ],
                            [
                                133.0892544400306,
                                -25.87101100509336
                            ]
                        ]
                    ]
                }
            }
        ]
    },
    "deliveries": [
        {
            "kind": "product",
            "status": "delivered",
            "id": "db234757-415e-45ea-91fe-b4a3430d9262",
            "sourceId": "DS_PHR1B_201801080119199_FR1_PX_E133S26_0203_00541",
            "aoi": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            133.0892544400306,
                            -25.87101100509336
                        ],
                        [
                            133.1536981096795,
                            -25.87132836142507
                        ],
                        [
                            133.153641115244,
                            -25.92385213283325
                        ],
                        [
                            133.0892077568722,
                            -25.92358780411442
                        ],
                        [
                            133.0892544400306,
                            -25.87101100509336
                        ]
                    ]
                ]
            },
            "productType": "bundle",
            "radiometricProcessing": "REFLECTANCE",
            "imageFormat": "image/jp2",
            "crsCode": "urn:ogc:def:crs:EPSG::4326",
            "createdAt": "2018-12-03T16:26:12.587173+00:00",
            "price": 377,
            "_links": {
                "payment": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/5349b24f-eed4-44f6-a98b-d9ddd88e4cab/payments/ba1e9e2c-8d8d-4bf6-aac3-5ac880421e1e"
                },
                "catalogUrl": {
                    "href": "https://search.oneatlas.geoapi-airbusds.com/api/v1/opensearch/opensearch?id=b5213e1e-ea50-4594-a42b-4a6439f88617"
                },
                "download": {
                    "href": "https://view.oneatlas.geoapi-airbusds.com/api/v1/b5213e1e-ea50-4594-a42b-4a6439f88617/download"
                }
            }
        }
    ]
}

View Order Status

The /orders endpoint can be used to retrieve the status of your orders:

API Endpoint/api/v1/orders
REST verbGET
AuthenticationJWT Token
API ReferenceOrder API

Here below is an example of a call:

curl -X GET "https://data.api.oneatlas.airbus.com/api/v1/orders" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache"
var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = false;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://data.api.oneatlas.airbus.com/api/v1/orders");
xhr.setRequestHeader("Authorization", "Bearer <access_token>");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Cache-Control", "no-cache");

xhr.send(data);
import requests

url = "https://data.api.oneatlas.airbus.com/api/v1/orders"

headers = {
    'Authorization': "Bearer <access_token>",
    'Content-Type': "application/json",
    'Cache-Control': "no-cache",
    }

response = requests.request("GET", url, headers=headers)

print(response.text)

A filter could be associated to this request to display orders that have a specific status. Available statuses for orders are the following ones:

StatusDescription
errorAn error occurred during the production process.
deliveredThe products have been produced and available in your private workspace.
orderedThe products have just been ordered and will be processed; the production is in progress.
rejectedThe order has been rejected, insufficient balance.

Also, it is possible to filter per product kind, two kinds being available:

KindDescription
order.subscription.streamingAny order such as a view subscription or change detection subscription
order.productIndividual product

If there are a lot of results to list, there’s a pagination mechanism to limit the number of results. If you want to activate it, the itemsPerPage parameter can be used.


For example, listing the first order delivered could be requested by using the following:

curl -X GET "https://data.api.oneatlas.airbus.com/api/v1/orders?status=delivered&kind=order.subscription.streaming&page=1&itemsPerPage=2" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache"
var data = null;

var xhr = new XMLHttpRequest();
xhr.withCredentials = false;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("GET", "https://data.api.oneatlas.airbus.com/api/v1/orders??status=delivered&itemsPerPage=1");
xhr.setRequestHeader("Authorization", "Bearer <access_token>");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Cache-Control", "no-cache");

xhr.send(data);
Not available

And the associated response:

{
    "startIndex": 0,
    "totalResults": 1,
    "itemsPerPage": 1,
    "items": [
        {
            "_links": {
                "self": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/69992522-c156-4925-aebc-9e7a91b11485"
                },
                "contract": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/5349b24f-eed4-44f6-a98b-d9ddd88e4cab"
                },
                "payments": {
                    "href": "https://data.api.oneatlas.airbus.com/api/v1/orders/69992522-c156-4925-aebc-9e7a91b11485/payments"
                }
            },
            "id": "69992522-c156-4925-aebc-9e7a91b11485",
            "kind": "order.product",
            "createdAt": "2018-12-03T15:45:46.543671+00:00",
            "createdBy": "75e0cc0b-bece-47bb-fa1c-0644d3fe3cf6",
            "status": "delivered",
            "contractId": "5349b24f-eed4-44f6-a98b-d9ddd88e4cab",
            "price": 377,
            "payload": {
                "kind": "order.product",
                "products": [
                    {
                        "productType": "bundle",
                        "radiometricProcessing": "REFLECTANCE",
                        "imageFormat": "image/jp2",
                        "crsCode": "urn:ogc:def:crs:EPSG::4326",
                        "id": "db234757-415e-45ea-91fe-b4a3430d9262",
                        "aoi": {
                            "type": "Polygon",
                            "coordinates": [
                                [
                                    [
                                        133.0892544400306,
                                        -25.87101100509336
                                    ],
                                    [
                                        133.1536981096795,
                                        -25.87132836142507
                                    ],
                                    [
                                        133.153641115244,
                                        -25.92385213283325
                                    ],
                                    [
                                        133.0892077568722,
                                        -25.92358780411442
                                    ],
                                    [
                                        133.0892544400306,
                                        -25.87101100509336
                                    ]
                                ]
                            ]
                        }
                    }
                ]
            },
            "deliveries": [
                {
                    "kind": "product",
                    "status": "delivered",
                    "id": "db234757-415e-45ea-91fe-b4a3430d9262",
                    "sourceId": "DS_PHR1B_201801080119199_FR1_PX_E133S26_0203_00541",
                    "aoi": {
                        "type": "Polygon",
                        "coordinates": [
                            [
                                [
                                    133.0892544400306,
                                    -25.87101100509336
                                ],
                                [
                                    133.1536981096795,
                                    -25.87132836142507
                                ],
                                [
                                    133.153641115244,
                                    -25.92385213283325
                                ],
                                [
                                    133.0892077568722,
                                    -25.92358780411442
                                ],
                                [
                                    133.0892544400306,
                                    -25.87101100509336
                                ]
                            ]
                        ]
                    },
                    "productType": "bundle",
                    "radiometricProcessing": "REFLECTANCE",
                    "imageFormat": "image/jp2",
                    "crsCode": "urn:ogc:def:crs:EPSG::4326",
                    "createdAt": "2018-12-03T15:45:46.970533+00:00",
                    "price": 377,
                    "_links": {
                        "payment": {
                            "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/5349b24f-eed4-44f6-a98b-d9ddd88e4cab/payments/7a6cefc9-7cf2-4a12-8001-95e576afa3c8"
                        },
                        "catalogUrl": {
                            "href": "https://search.oneatlas.geoapi-airbusds.com/api/v1/opensearch/opensearch?id=c1981108-e741-4a4c-8b71-089235e3dd19"
                        },
                        "download": {
                            "href": "https://view.oneatlas.geoapi-airbusds.com/api/v1/items/c1981108-e741-4a4c-8b71-089235e3dd19/download"
                        }
                    }
                }
            ]
        }
    ]
}