GLOBHE logo
Developers

Create Order

Order drone data for a specific area of interest. The order endpoint must include the following items:

  • deliveryDeadline : represents the deadline by which you want to receive the data
  • locationMap : represents the coordinates of the polygon of the area of interest. it should consist of an array of lat and lng, with each lat and lng corresponding to an edge of the polygon.
  • description : represents a detailed description of what the clients needs. It is recommended to write as much description as possible to detail the requirements of the client in terms of resolution, equipments, product, safety concerns...
  • mapTypes : represents the end product that the client is requesting. Currently supporting only
    _2dMap 
    _3dMap 
    elevationMap 
    digitalTerrainModel 
    digitalSurfaceModel 
    topographicMap 
    thermalMap 
    ndvi 
    streamedData 
    originalPhotos 

The order endpoint can include the following:

  • clientEmail : represents the email address that the notification will be sent to. If not inserted, the email address associated with the API key will be used.
  • clientName : represents the client name. If not inserted, the name associated with the API key will be used.
  • companyName : represents the company name. If not inserted, the company name associated with the API key will be used.
  • notifications : to specify if the client wants to be notified via a webhook and via email when the status of the order changes.
  • otherMapType : in case the map type is not the one that is listed above, you can insert it here.
Supported Map Types
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
streamedDatarepresents a Live streamed data (video footage)
originalPhotosrepresents Raw data/photos straight from the drone that have not been processed into another product
Example Request
POST https://us-central1-globhe-app.cloudfunctions.net/api/v1/orders
{
  "deliveryDeadline": "2022-10-01",
  "locationMap": [
    {
      "lat": -26.652673646040256,
      "lng": -6.2430225172747384
    },
    {
      "lat": -26.713196983259046,
      "lng": 2.2772415512977204
    },
    {
      "lat": 17.441499309513688,
      "lng": 108.58612411318285
    }
  ],
  "mapTypes": [
    "_2dMap",
    "elevationMap"
  ],
  "description": "A detailed description of the data capture requirements goes here",
  "clientEmail": "foo@foo.com",
  "clientName": "Darth Vader",
  "companyName": "The First Galactic Empire",
  "notifications": {
    "webhook": "http://YKgmigAHHvGCfxhGJqpjcuY.sufbf1IWOF3R.encEUQoZ5fWDGiZ6wlRi2hFLgHsWzf58-Asm9",
    "email": false
  },
  "otherMapType": "in Ut amet"
}
Example Response
{
  "id": "adipisicing123456789",
  "areaSize": 85301325.0620738,
  "clientEmail": "foo@foo.com",
  "deliveryDeadline": "2022-10-01",
  "clientName": "Darth Vader",
  "companyName": "The First Galactic Empire",
  "deliveryFiles": [
    "https://QASqjdhKvlxiCNNJwUHJrFmzLBWTjh.ockrTYSZnMhrJl9QM3uEOKjrjpVdpQTqhvvDQusfv",
    "http://l.gmpdgsdfgjkGhjFRyDSbhjTYYGHJghjTYvUVuVYuVjSDSdnmb",
    "http://l.gmpwkRAZCHIVptOfZ3DSDA56GHJbncGbnFSDAMSDbnmSDSDWEhjkqwVYUDSghjadA",
    "http://l.gmpwkRAZCHIVptOfZ3HJWOpHuubnmFHjkEhjVuiopWbnAhjkASdkjhJJH"
  ],
  "description": "A detailed description of the data capture requirements goes here",
  "orderPrice": 44927494.15693178,
  "orderStatus": "active",
  "orderRejectionReason": "anim dolor dolore ex",
  "locationMap": [
    {
      "lat": 47.40430222489124,
      "lng": -33.278262875341284
    },
    {
      "lat": -17.70925800990831,
      "lng": 144.48954366869725
    }
  ],
  "mapTypes": [
    "_2dMap",
    "elevationMap"
  ],
  "notifications": {
    "webhook": "https://uLDIaEmhpasAXxN.xfsYQI7WVtzY96ZiVGIL8uvEwUid+C7Z,A,.5Or",
    "email": true
  },
  "otherMapType": "ut incididunt labore"
}