GLOBHE logo
Developers

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/v1/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.

mapTypesDescription
_2dMaprepresents a 2D Orthomosaic Map
_3dMaprepresents a 3D model or point cloud
elevationMaprepresents a topographic Map with contour values
digitalTerrainModelrepresents a digital terrain model
digitalSurfaceModelrepresents a digital surface model
thermalMaprepresents a thermal Map
ndvirepresents a plant health map made through an NDVI algorithm
multispectralmultispectral data captures light across specific wavelengths beyond the visible spectrum, such as red, green, blue, red edge (RE), and near-infrared (NIR) bands
streamedDatarepresents a Live streamed data (video footage)
rawrepresents Raw data/photos in .dng format straight from the drone and that have not been processed into another product
panoramasrepresents 360 panoramas taken from a single point with a drone
LiDARrepresents 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/v1/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"
        ]
      }
    }
  }
]