List all purchased data library datasets
You can get a list of all your purchased datasets from the data library that were purchased by the same user and the same API key.
POST https://us-central1-globhe-app.cloudfunctions.net/api/v2/datalibraryorders The List Orders endpoint supports filtering on data delivery product and specifying the page and the limit with the following query parameters. The listing endpoints can include the following:
fileDataType: represents the data delivery product that is available. See below for details on the available data delivery products. If none is selected, only the baseFiles will be returned in the response. This can contain up to 10 filters at a time.page: This parameter is used to fetch the records of particular page and it starts from 0. Each page typically contains a predefined number of items or records. By incrementing the page value, you can navigate through the available pages of data until you have retrieved all the desired information. If not specified, the page will return 0.limit: itrefers to the maximum number of items or records that can be returned in a single API response. It allows you to control the quantity of data you want to retrieve from the API at once. If not specified the limit will be 10.
Supported data delivery products
Delivery is separated into two groups: 'baseFiles' that consist of the unprocessed individual jpg images that the drones capture, and the processed data that contains all the processed delivery products listed below.
Note that the processed data contains only the delivery products that you specified in the order request.
| mapTypes | Description | |
|---|---|---|
| _2dMap | represents a 2D Orthomosaic Map | |
| _3dMap | represents a 3D model or point cloud | |
| elevationMap | represents a topographic Map with contour values | |
| digitalTerrainModel | represents a digital terrain model | |
| digitalSurfaceModel | represents a digital surface model | |
| thermalMap | represents a thermal Map | |
| ndvi | represents a plant health map made through an NDVI algorithm | |
| multispectral | multispectral data captures light across specific wavelengths beyond the visible spectrum, such as red, green, blue, red edge (RE), and near-infrared (NIR) bands | |
| streamedData | represents a Live streamed data (video footage) | |
| raw | represents Raw data/photos in .dng format straight from the drone and that have not been processed into another product | |
| panoramas | represents 360 panoramas taken from a single point with a drone | |
| LiDAR | represents precise 3D representations of objects and environments visualised in a point cloud. It is captured using laser light to measure distance |
Example Request
POST https://us-central1-globhe-app.cloudfunctions.net/api/v2/datalibraryorders {
"fileDataType": [
"_2dMap",
"digitalTerrainModel"
],
"page": 0,
"limit": 10
}Example response
[
{
"id": "9orj8k23",
"datasetName": "Dataset name",
"categories": [
"forestry",
"orthomosaics"
],
"description": "This is a brief description of this datasets and what it contains",
"sdgGoals": [
"goal1",
"goal2"
],
"locationLabel": "Oriximiná - State of Pará, 68270-000, Brazil",
"locationMap": [
{
"lng": -56.28995416860816,
"lat": -1.1943083787212674
},
{
"lng": -56.20618341665504,
"lat": -1.1805784177529681
},
{
"lng": -56.19245050649879,
"lat": -1.2217680940951903
},
{
"lng": -56.26660822134254,
"lat": -1.2368708183180714
}
],
"dateCompleted": "2021-02-28",
"deliveryFiles": {
"baseFiles": [
"https://someURL",
"https://someURL",
"https://someURL"
],
"processedData": {
"_2dMap": [
"https://someURL"
]
}
}
},
{
"id": "k1PSDzp5x5i2cbcbbGTA",
"datasetName": "Dataset name",
"categories": [
"NDVI",
"environment"
],
"description": "This is a brief description of this datasets and what it contains",
"sdgGoals": [
"goal5"
],
"locationLabel": "W5VW+9W Andranofeno, Madagascar",
"locationMap": [
{
"lng": 46.318359375,
"lat": -16.63619187839765
},
{
"lng": 48.076171875,
"lat": -16.63619187839765
},
{
"lng": 47.197265625,
"lat": -19.476950206488414
}
],
"dateCompleted": "2022-11-04",
"deliveryFiles": {
"baseFiles": [
"https://someURL",
"https://someURL",
"https://someURL"
],
"processedData": {
"_2dMap": [
"https://someURL"
]
}
}
}
]