SDK Introduction
The Alteia SDK (Software Development Kit) is a high-level Python set of tools, libraries, and code samples developed to leverage Alteia's APIs. With it, developers quickly create, test, and develop specific applications on top of Aether. This allows you to enrich the user experience and business workflows with advanced functionality. In addition, you can seamlessly integrate Alteia with other applications, for example, to send push notifications and data, and collect industry-specific or customer-specific analytics.
The kit consists of a code library, examples, documentation, and the methodology necessary to perform specific functions, essentially everything you need to create your own modules and retrieve analytics.
You can use the Alteia SDK to do the following:
- Connect remotely to Aether to exchange and manage data input/output
- Fetch a project, browse its missions
- List deliverables, download files
- Create a new project with pictures or vectors
- Annotate data in a project
- Search for annotations associated with a project
- Update & delete annotations (update geometry, properties, and other attributes)
- Annotate an image
- Process a raster and deliver the output
- Fetch a process area from an annotation
- Train or run a custom algorithm as a subprocess
- Upload and deliver the algorithm output
Before you begin
Before you start implementing the Alteia SDK, make sure to do the following:
Install
Install the latest Alteia Python package release via pip:
pip install alteia |
The Alteia Python SDK has a unique entry point through the "alteia.sdk.SDK" class. So, to use the SDK, first configure your Alteia credentials with a configuration file. All configuration files must be written in JSON format as a single JSON object, using only the supported properties:
user |
The user identifier. Required is not provided through a configuration file, nor using "client_id." |
password |
The account password. Required if not provided through a configuration file and "user" is used. |
client_id |
An OAuth client identifier. Required if not provided through a configuration file and "user" is used. |
client_secret |
The OAuth client secret. Required if not provided through a configuration file and "client_id" is used. |
access_token |
An optional API access token to use to authenticate requests as an alternative to using "user" or "client_id." |
url |
The public endpoint of Alteia. Default to "https://app.alteia.com." |
connection |
A dictionary providing the connection configuration |
proxy_url |
An optional proxy URL. The value of "https_proxy" or "http_proxy" environment variable will override if set. |
Here is an example of the "config-connection.json" configuration file:
{"user": "firstname.lastname@example.com",
"password": "20h!nph-14-12394"} |
| Windows: | %USERPROFILE%\Application\Application Data\Alteia\alteia\ |
| Linux: | ~/.local/share/alteia/ |
| MacOS: | ~/Library/Application Support/alteia/ |
To go further
You can find all the information about the Alteia SDK by clicking on the link below:
