Get AOI

Get AOI by ID. Only the AOIs under current service user will be accessible.

GET/v0/aoi/{aoi_id}

Authorisations

AuthorizationString

Path Parameters

aoi_idstringrequired

AOI ID

Response

application/json

aoi_idstring

Unique identifier (UUID) of the created AOIExample: "e9767554-550e-4464-a677-b8cf096073ab"

namestring

Unique user friendly name of the AOI for easier identificationExample: "AOI-D2"

descriptionstring

Brief description of the AOI explaining its purpose or contentsExample: "This AOI contains images of D2"

satellite_idstring

Unique identifier (UUID) for the satellite. Each satellite has a unique ID mapped to its name: - `Pixxel-TD1` - `0004ab8d-0ad1-4d62-8a3f-fe18a7000e70` - `Pixxel-TD2` - `0005c5bb-0bd2-4c80-9393-4a808341c54c`Example: "0005c5bb-0bd2-4c80-9393-4a808341c54c"

project_idstring

UUID of the project this AOI belongs toExample: "ce5dcc14-8291-4b0c-a278-8c05ec426d22"

imagesobject

Map of images associated with the AOI, keyed by image identifier

eo_bandsstring[]

List of Earth Observation bands available for this AOIExample: ["B01","B02","B03"]

geometryobject

GeoJSON Polygon geometry defining the geographic boundary of the AOI

Show child attributes

progressinteger

Processing progress of the AOI from 0 to 100 in percentageExample: 100

statusstring

Current status of the AOI: success, started, running, failed, updating, partial_successExample: "success"

is_favouriteboolean

Whether the AOI is marked as favourite by the userExample: false

created_atstring

Timestamp when the AOI was created (ISO 8601 format)Example: "2022-11-14T12:55:49.125928+00:00"

updated_atstring

Timestamp when the AOI was last updated (ISO 8601 format)Example: "2022-11-14T12:55:49.125928+00:00"

user_idstring

Unique identifier of the user who created the AOIExample: "user-123456"

area_in_sq_mnumber

Total area of the AOI in square metersExample: 123456.78

centroidnumber[]

Geographic centroid coordinates of the AOI [longitude, latitude]Example: [77.55,12.95]

Get AOI

1curl -X GET 'https://api.pixxel.space/v0/aoi/{aoi_id}' \
2  -H 'Authorization: YOUR_API_KEY'

Response:

{
  "aoi_id": "e9767554-550e-4464-a677-b8cf096073ab",
  "name": "AOI-D2",
  "description": "This AOI contains images of D2",
  "satellite_id": "0005c5bb-0bd2-4c80-9393-4a808341c54c",
  "project_id": "ce5dcc14-8291-4b0c-a278-8c05ec426d22",
  "images": {},
  "eo_bands": [
    "B01",
    "B02",
    "B03"
  ],
  "geometry": null,
  "progress": 100,
  "status": "success",
  "is_favourite": false,
  "created_at": "2022-11-14T12:55:49.125928+00:00",
  "updated_at": "2022-11-14T12:55:49.125928+00:00",
  "user_id": "user-123456",
  "area_in_sq_m": 123456.78,
  "centroid": [
    77.55,
    12.95
  ]
}