The package contains a configuration file
config.json. After the package is installed you can check the initial
configuration parameters in command line:
$ sentinelhub.config --show
Sentinel Hub Capabilities¶
instance_id parameter will be empty. In case you would like to use any capabilities of the package that
interact with Sentinel Hub services you can set your Sentinel Hub instance ID with:
$ sentinelhub.config --instance_id <your instance id>
By doing so the package will use this instance ID to interact with Sentinel Hub unless you purposely specify a different one in the code.
Amazon S3 Capabilities¶
The package enables downloading Sentinel-2 L1C and L2A data from Amazon S3 storage buckets. The data is contained in
Requester Pays buckets therefore AWS credentials are required to use these capabilities. The credentials
can be set in package’s configuration file with parameters
aws_secret_access_key. This can
be configured from command line:
$ sentinelhub.config --aws_access_key_id <your access key> --aws_secret_access_key <your secret access key>
In case the credentials are not set, the package will instead automatically try to use locally stored AWS credentials, if they were configured according to AWS configuration instructions. Any other configuration parameters (e.g. region) will also be collected the same way.
The AWS credentials also have to have correct permissions to be able to download data from S3 buckets. That can be configured in AWS IAM console. There are many ways how to configure sufficient permission, one of them is setting them to AmazonS3ReadOnlyAccess.
Important: Because satellite data at S3 is contained in Requester Pays buckets Amazon will charge users for download according to Amazon S3 Pricing. In this case users are charged for amount of data downloaded and the number of requests. The sentinelhub package will make at most one GET request for each file downloaded. Files metadata.xml, tileInfo.json and productInfo.json will be obtained without any charge from Sentinel Hub public repository.
For more configuration options check:
$ sentinelhub.config --help