Skip to main content

Ingest data

Orbis works with Instrument, Acquisition and Asset as basic processing units that flow through the system:

  • Instrument is a satellite payload, such as camera. It currently represents a fundamental element belonging directly to the user account and owning Acquisitions. The Instrument's technical information necessary for processing is recorded and updated as part of mission set up and operations
  • Acquisition is a record for a single, separable measuring event of the satellite’s instrument (single image, single datatake).
  • Asset represents the data under Acquisition. It contains data, such as binary images or large text-like structures. Data format often depends on the sensing principle of the instrument.

This hierarchy enables us to ensure the flexibility to accept data in various formats, granularity and structures, given the complexity of the satellite acquisition process and subsystem synchronisation.

info

Ingestion API enables ingesting Instrument's Acquisitions and Assets to Orbis.

Prerequisites​

  1. Have an API key, which can be generated in your API keys section. This gets passed as a header (x-orbis-api-key).
  2. Have your Instrument's ID, available in your Instruments section. This gets passed as a header (x-orbis-instrument-id)

How to ingest nominal data​

  1. POST Acquisition with required data. When sucessful, you will receive its ID.
  2. POST Asset with required metadata to prepare for submitting data. Each Acquisition expects Assets with consistent properties. You will find the expected asset properties in expected assets by viewing your Instrument in the Instruments section. When sucessful, you will receive an URL for uploading asset data.
  3. Upload (PUT) asset data to the provided URL. No headers are required for the upload.
info

Download a sample Postman collection to try API requests: Ingestion API.postman_collection.json

Use our ingestion services​

We understand that not all missions generate the same data or do not wish to transform them into processing parameters required by us. Leverage our domain knowledge and send us the data you have available in an unprocessed format. Once we agree on a consistent structure, we will work out the compatibility transformations to Orbis.

info

📢 Talk with us on how we can help you.