Access data products
Distribution of data products processed by Orbis is based on SpatioTemporal Asset Catalog (STAC). This technology has already a large user base and it is becoming widespread in the EO domain. It is a common language to describe geospatial data and metadata and to specify a data discovery API. STAC is made cloud-first so that all data can be accessed separately without a need to download large monolithic products.
There are two default ways of accessing the data products:
- Through the web app. The product browser is a part of Orbis web app making it convenient to explore, search, filter and download one or multiple data products by Collections in a human-friendly way.
- Orbis distribution API. Distribution API is a STAC-based specification with for machine data exploration, and can be used to connect Orbis to your infrastructure.
If other distribution formats are required, let us know how we can adjust to your preferences.
Navigate Distribution API
Prerequisites
- Be registered to the system
- Have your user email and password ready.
Process
Authorizing to Distribution API is done using a JWT token.
GETrequest https://api.orbis.worldfrom.space/auth/token with the following headers:x-orbis-username: your emailx-orbis-password: your password
- You will receive JWT token
id_token - You can send distribution API requests with header
Authorization: Bearer id_token. You can start with: https://api.orbis.worldfrom.space/distribution/stac
Default data product format
The format of a processed data product is a STAC Item. It follows the STAC core spec and official STAC extensions. It is a JSON with product metadata and linking assets (images, thumbnails, sidecar metadata) by URLs. Orbis data product is fully compatible with STAC Item and moreover, it can feature custom properties produced by Orbis.
Data products belong to STAC Collections, which separate sets of consistent data products by instrument, processing pipeline type, data owner and similar.
Orbis data product example
{
"id": "e8f6305e-6ee8-548e-9a1e-177ce5532095",
"type": "Feature",
"stac_version": "1.0.0",
"stac_extensions": [],
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-84.57539127738428,
33.574065011558865
],
[
-84.3039973545141,
33.574065011558865
],
[
-84.3039973545141,
33.75948672350203
],
[
-84.57539127738428,
33.75948672350203
],
[
-84.57539127738428,
33.574065011558865
]
]
]
},
"bbox": [
-84.5753912773843,
33.5740650115589,
-84.3039973545141,
33.759486723502
],
"datetime": "2022-04-22T20:03:40.537000Z",
"properties": {
"created": "2024-07-01T15:08:12+00:00",
"updated": "2024-07-01T15:08:12+00:00",
"start_datetime": "2022-04-22T20:03:40.537000+00:00",
"end_datetime": "2022-04-22T20:03:40.537000+00:00",
"mission": "Super Cool Mission",
"platform": "Super Cool Satellite",
"constellation": "Super Cool Constellation",
"instruments": [
"Panchromatic Camera 1"
],
"raster:bands": [
{
"unit": "m",
"scale": 0.8,
"nodata": 0,
"offset": 0,
"spatial_resolution": 4.74
}
],
"view:off_nadir": 7.6,
"sat:orbit_state": null,
"orbis:orbit_type": "sun-synchronous",
"processing:level": "Level 1B (pseudo)",
"orbis:mission_type": "EO",
"orbis:payload_type": "panchromatic",
"orbis:sensor_size_x": 4096,
"orbis:sensor_size_y": 3072,
"processing:software": "Orbis PAN L1B (pseudo) pipeline v1",
"orbis:active_pixels_x": [
8,
4087
],
"orbis:active_pixels_y": [
0,
3071
],
"orbis:attitude_sat_pos": [
33.000456,
-84.111071,
12.324544
],
"orbis:tle": [
"1 48915U 21059AN 22111.42068304 .00003538 00000-0 20029-3 0 9993",
"2 48915 97.5435 241.3617 0010184 292.0731 67.9418 15.13653665 45302"
],
"orbis:integration_time": 550,
"product:acquisition_type": "nominal",
"orbis:mission_launch_vehicle": "Starship",
"orbis:bit_depth": 8,
"orbis:orbit_designed_altitude": "LEO",
"orbis:mission_operational_since": "2021-06-30",
"orbis:mission_operational_status": "nominal",
"orbis:constellation_satellite_number": 1,
"orbis:constellation_active_satellites": 4,
"sat:platform_international_designator": "2024-099VCXX"
},
"links": [
{
"href": "https://api.orbis.worldfrom.space/distribution/stac/collections/collection/items/top-secret-image",
"rel": "self",
"type": "application/geo+json",
"title": null,
"method": null
},
{
"href": "https://api.orbis.worldfrom.space/distribution/stac/collections/yam3pan-l1b-pseudo",
"rel": "parent",
"type": "application/json",
"title": null,
"method": null
},
{
"href": "https://api.orbis.worldfrom.space/distribution/stac/collections/yam3pan-l1b-pseudo",
"rel": "collection",
"type": "application/json",
"title": null,
"method": null
},
{
"href": "https://api.orbis.worldfrom.space/distribution/stac",
"rel": "root",
"type": "application/json",
"title": null,
"method": null
}
],
"assets": {
"b01": {
"href": "https://amazonaws.com/b01.tiff",
"type": "image/tiff",
"title": null,
"description": null,
"roles": [
"data"
],
"properties": {
"size": 20914902,
"roles": [
"data"
]
}
},
"thumbnail": {
"href": "https://amazonaws.com/thumbnail.jpeg",
"type": "image/jpeg",
"title": null,
"description": null,
"roles": [
"thumbnail"
],
"properties": {
"size": 2075,
"roles": [
"thumbnail"
]
}
},
"validity_mask": {
"href": "https://amazonaws.com/validity_mask.tiff",
"type": "image/tiff",
"title": null,
"description": null,
"roles": [
"data"
],
"properties": {
"size": 20914902,
"roles": [
"data"
]
}
}
},
"collection": "top-secret-collection"
}