The glossary provides information on UP42 data offerings. It helps you create tasking or catalog orders.
Collections are geospatial datasets available for ordering.
You can retrieve collections in one of the following ways:
- To get a list of all collections, call the Get geospatial collections endpoint.
- To get a specific collection, call the Get a geospatial collection endpoint with the collection name as the path parameter.
Integration values indicate mandatory ordering steps, available actions, and mandatory or optional operations for a given collection. You can search for collections with specific integration values by specifying them in the integrations query parameter of the Get geospatial collections endpoint.
Integration values for mandatory ordering steps have the REQUIRED suffix.
| Integration value | Description |
|---|---|
ACCESS_APPROVAL_REQUIRED | This collection is restricted and requires an access request. |
MANUAL_REQUEST_REQUIRED | This collection isn’t integrated either on the console or the API and requires filling out an ordering form from its marketplace page. |
QUOTATION_REQUIRED | The ordering process for this collection includes a price quotation. |
Integration values for available actions have the AVAILABLE suffix.
| Integration value | Description |
|---|---|
SAMPLE_DATA_AVAILABLE | This collection has sample data. |
SEARCH_AVAILABLE | This collection allows for a catalog search. |
PRICE_ESTIMATION_AVAILABLE | This collection allows for automatic price estimation. |
QUICKLOOK_AVAILABLE | This collection has quicklooks, that is, previews of full scenes on a basemap. |
THUMBNAIL_AVAILABLE | This collection has thumbnails, that is, small, light-weighted previews of full scenes. |
Integration values for either mandatory or optional operations have the MAY_BE_REQUIRED suffix.
| Integration value | Description |
|---|---|
FEASIBILITY_MAY_BE_REQUIRED | A feasibility study might be required for ordering this collection. |
Data products are a type of imagery with a specific geometric and radiometric processing level and file format. All collections have different data products corresponding to their technical specifications.
You can retrieve data products in one of the following ways:
- To get a list of all data products, call the Get data products endpoint.
- To get a specific data product, call the Get a data product endpoint with the data product name as the path parameter.
To create a tasking or a catalog order, you will need a data product ID.
Data producers are companies that initially acquire and process the source data. Data acquired by a producer can be distributed to various hosts.
To get a list of all available data producers with metadata, call the Get data producers endpoint.
A simplified table of data producers
| Title | Name |
|---|---|
| 21AT | 21at |
| Airbus | airbus |
| Axelspace | axelspace |
| Beijing Space View Technology Co., Ltd. | space-view |
| BlackSky | blacksky |
| Capella Space | capella-space |
| Deutsches Zentrum für Luft-und Raumfahrt e. V. | dlr |
| Deutsches Zentrum für Luft-und Raumfahrt e. V. and Hisdesat Servicios Estratégicos S.A. | dlr-hisdesat |
| ESA | esa |
| GEOSAT | geosat |
| Hexagon | hexagon |
| ICEYE | iceye |
| ImageSat | imagesat |
| Intermap | intermap |
| Near Space Labs | near-space-labs |
| Nearmap | nearmap |
| Satellogic | satellogic |
| SIIS | siis |
| Umbra | umbra |
| United States Geological Survey | usgs |
| Vexcel | vexcel |
| Wyvern | wyvern |
Data hosts are providers that offer access to data acquired by a producer. Hosts are either commercial or non-commercial. Non-commercial hosts provide access to open data.
To get a list of available data hosts with metadata, call the Get data hosts endpoint.
A simplified table of data hosts
| Title | Data access type | API name |
|---|---|---|
| 21AT | Commercial | 21at |
| Airbus Defence and Space | Commercial | airbus |
| Airbus Defence and Space - Elevation | Commercial | airbus-elevation |
| Axelspace | Commercial | axelspace |
| Capella Space | Commercial | capellaspace |
| Earth Search & AWS | Non-commercial | earthsearch-aws |
| GEOSAT | Commercial | geosat |
| Hexagon | Commercial | hexagon |
| ICEYE | Commercial | iceye |
| ImageSat | Commercial | imagesat |
| Intermap | Commercial | intermap |
| Near Space Labs | Commercial | nearspacelabs |
| OneAtlas | Commercial | oneatlas |
| OneAtlas Advanced | Commercial | oneatlas-advanced |
| Satellogic | Commercial | satellogic |
| SIIS | Commercial | siis |
| Spectra | Commercial | spectra |
| Umbra | Commercial | umbra |
| Vexcel | Commercial | vexcel |
| Wyvern | Commercial | wyvern |