Our SDK 🔧

Python or CLI

teledetection is a Python SDK (Software Development Kit) to interact with our servers. It can be used in command-line or used as a dependency.

Installation

Your can install our SDK from pip:

pip install teledetection

Usage

Once the environment setup:

import teledetection as tld
import pystac_client

api = pystac_client.Client.open(
   'https://api.stac.teledetection.fr',
   modifier=tld.sign_inplace,
)

Authentification

There are 2 different ways of authentificating on our servers during a development:

Method	Generation method	Duration	Usage
OAuth2	By `teledetection`	Temporary (5 days, renewed when `sign_inplace` is called), `teledetection` asks to reauthentificate after expiration	When using `teledetection` on Python
API Key	- By `tld` (binary provided with `teledetection`) - On our Gate website	Permanent

Examples

To see how to play with our library, check our Jupyter notebooks examples

Upload data

Our SDK also enables to push data on our database. For this, check teledetection’s documentation.

Contribute

You can create a pull request or open an issue on Github.

Documentation

Read the latest documentation here.

R

rstactheia is the R package to authenticate and sign the asset URLs.

See documentation for details.