RDA (DigitalGlobe Raster Data Access)

(GDAL/OGR >= 2.3)

This driver can connect to DigitalGlobe RDA REST API. GDAL/OGR must be built with Curl support in order for the RDA driver to be compiled.

The driver retrieves metadata on graphs and fetches the raster by tiles. Data types byte, uint16, int16, uint32, int32, float32 and float64 are supported.

Any valid graph or template is supported via the DigitalGlobe RDA REST API.

There is no support for overviews.

Dataset name syntax

The minimal syntax to open a datasource is :
{"graphId":"some_value", "nodeId": "another_value"}
OR
{"templateId":"some_value", "parameters": { "someparam": "someparamval"}}

So a JSon serialized document with 2 attributes graph-id and node-id.

Those values can for example be retrieved from graphs built by GraphStudio.

Connection String options (optional)

Authentication

Access to the API requires an authentication token. For that, 2 parameters (username, password) must be provided to the driver. They can be retrieved from the below configuration options, or from the ~/.gbdx-config file.

The access token will be cached in ~/.gdal/rda_cache/authentication.json and reused from there until its expiration period is reached.

Configuration options

The following configuration options are available :

~/.gbdx-config file

This file may be created in the home directory of the user (value of the $HOME environment variable on Unix, $USERPROFILE on Windows). It can contain values from the above configuration options.

[gbdx]
auth_url = https://geobigdata.io/auth/v1/oauth/token/ (optional)
rda_api_url = https://rda.geobigdata.io/v1 (optional)
user_name = value (required)
user_password = value (required)

Caching

By default, the authentication token is cached in the ~/.gdal/rda_cache directory. This directory may be changed with the RDA_CACHE_DIR configuration option. By default, dataset metadata and tiles are temporarily cached in ~/.gdal/rda_cache/{graph-id}/{node-id}, and deleted on dataset closing, unless

"options": {"delete-on-close": false}
is found in the dataset name.

Open Options

By default, the number of concurrent downloads will be 8*number of CPUs up to a maximum of 64. The maximum number of concurrent connections can be configured by the MAXCONNECT option

Examples