Language
OneAtlas Data Guide
  1. Download Service
    1. Retrieve Your Product
    2. Download Your Product

Download Service

OneAtlas Data API not only gives you the ability to stream imagery, but also allows you to download your product locally onto your machine. This section presumes you have already purchased the product and that it’s within your workspace. If you have not yet purchased a product you can do this by following our order guide.

Retrieve your Product

We can use the endpoint contracts/<contract_id>/orders to list all your orders within your contract. An example of the data returned is shown below:

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

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

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

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

xhr.send(data);
import requests

url = "https://data.api.oneatlas.airbus.com/api/v1/contracts/<contract_id>/orders"

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

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

print(response.text)

Note: Orders are displayed by date processed. Therefore if you have just purchased a product, your order will be at the top.

This will return deliveries[] which contains your ordered products. Your delivery will start as status ordered and will change to delivered when it is ready to download:

"deliveries": [
    {
        "kind": "product",
        "status": "delivered",
        "id": "be12702e-7106-431b-a443-1211cb9e2b67",
        "sourceId": "DS_PHR1B_201612141550258_FR1_PX_W074N40_0218_00592",
        "aoi": {
            "type": "Polygon",
            "coordinates": [
                [
                    [
                        -73.98908810530638,
                        40.75798367194725
                    ],
                    [
                        -73.73154906627816,
                        40.75351463446797
                    ],
                    [
                        -73.73183498245874,
                        40.68606048838986
                    ],
                    [
                        -73.98886543752272,
                        40.69021358085354
                    ],
                    [
                        -73.98908810530638,
                        40.75798367194725
                    ]
                ]
            ]
        },
        "productType": "bundle",
        "radiometricProcessing": "REFLECTANCE",
        "imageFormat": "image/jp2",
        "crsCode": "urn:ogc:def:crs:EPSG::4326",
        "createdAt": "2018-10-19T07:09:50.359420+00:00",
        "price": 1635,
        "_links": {
            "payment": {
                "href": "https://data.api.oneatlas.airbus.com/api/v1/contracts/69b39c17-e6d1-4552-8995-4ae19a8d9294/payments/zzzzzz-xxxxxx-wwwwww-vvvvvv"
            },
            "catalogUrl": {
                "href": "https://search.oneatlas.geoapi-airbusds.com/api/v1/opensearch/opensearch?id=zzzzzz-xxxxxx-wwwwww-vvvvvv"
            },
            "download": {
                "href": "https://view.oneatlas.geoapi-airbusds.com/api/v1/items/zzzzzz-xxxxxx-wwwwww-vvvvvv/download"
            }
        }
    }
]

Download your Product

If your product is at status delivered you will see a download url similar to the following:

https://access.foundation.api.oneatlas.airbus.com/api/v1/items/<contract_id>/download

You send a GET request to output your file as a zip file:

curl -k GET \
  https://access.foundation.api.oneatlas.airbus.com/api/v1/items/90ebd420-fab4-49b7-85cd-ced051ea2343/download \
  -H 'Authorization: Bearer <access_token>' -o output_file.zip
Not available
Not available

Here you can see the contents of the zip:

download_image