GLOBHE logo
Developers

Get details of a single dataset

You can get the details of a single purchased data library dataset with the request below, by specifying the dataset id field.

POST https://us-central1-globhe-app.cloudfunctions.net/api/v1/datalibraryorders/:id

You can also filter on data type. You can filter on the below data delivery products. To filter, you can include the following in the endpoint:

  • 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.
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/20220578syui
{
  "fileDataType": [
    "_2dMap",
    "digitalTerrainModel"
  ]
}
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"
      ],
      "digitalTerrainModel": [
        "https://someURL"
      ]
    }
  }
}