1. DroneDeploy
  2. App Market & Integrations
  3. API

REST: Measurements API

Updated
Have more questions? Submit a request
Take measurements via our API
Programmatically measure DroneDeploy map data. It is primarily used by partners who are rendering dronedeploy data in their own mapping application, and want to take advantage of our server side measurement features.

First you will need an API Key

Coordinate Geometry Format

All coordinate geometry are passed in on the URL using the Well Known Text (WKT) format. Since WKT includes spaces which are not valid in URLs they have to be encoded with %20 instead.

All points but be in WGS84 ordered as Longitude, Latitude.

Elevation at a point

Get the elevation data for a single point on your plan.

GET /v2/tiles/<plan_id>/points/POINT(<lng> <lat>)

  • The plan_id can be obtained by listing your plans
  • lng lat is the longitude, latitude pair of the point

Returns JSON - Array of one Elevation Point Objects

curl "https://public-api.dronedeploy.com/v2/tiles/5605c0e5752afc005a000004/points/POINT(-96.7493%2035.9272)?api_key={api_key}"

[
  {
    "lat": 35.9272,
    "lng": -96.7493,
    "aspect": 100.57501983642578,
    "elevation": -2.0494751930236816,
    "slope": 7.686941623687744
  }
]

Elevation at multiple points

Get the elevation data for a set of points in your plan.

GET /v2/tiles/<plan_id>/points/LINESTRING(<lng> <lat>,<lng> <lat>)

  • The plan_id can be obtained by listing your plans
  • lng lat is longitude, latitude pairs of points on the line

Returns JSON - Array of multiple Elevation Point Objects

curl "https://public-api.dronedeploy.com/v2/tiles/580fd790d5d264a5d8515a73/points/LINESTRING(-123.11389%2038.4264,-123.11376%2038.42633,-123.11392%2038.42624)?api_key={api_key}"

[
  {
    "lat": 35.9272,
    "lng": -96.7493,
    "aspect": 100.57501983642578,
    "elevation": -2.0494751930236816,
    "slope": 7.686941623687744
  },
  {
    "lat": 35.9282,
    "lng": -96.7493,
    "aspect": 100.57501983642578,
    "elevation": -2.0494751930236816,
    "slope": 7.686941623687744
  },
  {
    "lat": 35.9292,
    "lng": -96.7493,
    "aspect": 100.57501983642578,
    "elevation": -2.0494751930236816,
    "slope": 7.686941623687744
  }
]

Elevation profile

Get the elevation profile for a line segment in your plan.

GET /v2/tiles/<plan_id>/elevation_profile/LINESTRING(<lng> <lat>,<lng> <lat>)

  • The plan_id can be obtained by listing your plans
  • lng lat is the longitude, latitude pairs of the profile's end points

Returns JSON - Elevation Profile Object

curl "https://public-api.dronedeploy.com/v2/tiles/5605c0e5752afc005a000004/elevation_profile/LINESTRING(-96.748958 35.926247,-96.747933 35.926738)?api_key={api_key}"

{
  "length": 107.35063384719186,
  "endpoints": [
    [
      35.926247,
      -96.748958
    ],
    [
      35.926738,
      -96.747933
    ]
  ],
  "dx": 0.5394504213426726,
  "points": 200,
  "profile": [
    -3.2126803398132324,
    -2.9078261852264404,
    -2.5082149505615234,
    -2.1308653354644775,
    -1.8100733757019043,
    -1.588750958442688,
    -1.2454699277877808,
    -0.9110381603240967,
    -0.5182652473449707,
    0.017951250076293945,
    0.3872571289539337,
    0.7583861351013184,
    1.1496901512145996,
    1.3351891040802002,
    1.378787636756897,
    1.4234232902526855,
    1.5108965635299683,
    1.5374040603637695,
    1.5725595951080322,
    1.5344831943511963,
    1.5309009552001953,
    1.4504506587982178,
    1.1855295896530151,
    0.8832171559333801,
    0.6449069380760193,
    0.2592028081417084,
    -0.08317752927541733,
    -0.3966941833496094,
    -0.7038220167160034,
    -1.1947146654129028,
    -1.4212929010391235,
    -1.7537453174591064,
    -2.1012606620788574,
    -2.421973705291748,
    -2.8213231563568115,
    -3.2026727199554443,
    -3.5440573692321777,
    -3.888237714767456,
    -4.3575334548950195,
    -4.740445613861084,
    -5.080567836761475,
    -5.373325824737549,
    -5.5881805419921875,
    -5.942418575286865,
    -6.295977592468262,
    -6.609593391418457,
    -6.8115010261535645,
    -6.944386005401611,
    -7.042884826660156,
    -7.108870029449463,
    -7.186450958251953,
    -7.226156234741211,
    -7.263456344604492,
    -7.308847904205322,
    -7.306699752807617,
    -7.303905010223389,
    -7.342482566833496,
    -7.382180690765381,
    -7.397387981414795,
    -7.355391502380371,
    -7.358259677886963,
    -7.299555778503418,
    -7.293673038482666,
    -7.333643436431885,
    -7.331830024719238,
    -7.289070129394531,
    -7.2758378982543945,
    -7.2765655517578125,
    -7.274951934814453,
    -7.13649845123291,
    -6.97370719909668,
    -6.769287586212158,
    -6.556371688842773,
    -6.37256383895874,
    -6.200294017791748,
    -5.953836917877197,
    -5.808582782745361,
    -5.591289520263672,
    -5.431175708770752,
    -5.321629047393799,
    -5.167730331420898,
    -5.005058288574219,
    -4.799273490905762,
    -4.59376335144043,
    -4.353928565979004,
    -4.1515583992004395,
    -3.9867730140686035,
    -3.656733751296997,
    -3.604372978210449,
    -3.866297721862793,
    -4.011809825897217,
    -4.007779598236084,
    -3.969748020172119,
    -3.93691349029541,
    -3.906294584274292,
    -3.9203286170959473,
    -3.8839309215545654,
    -3.8729636669158936,
    -3.856013059616089,
    -3.8521084785461426,
    -3.8130006790161133,
    -3.857685089111328,
    -3.8235890865325928,
    -3.7519068717956543,
    -3.7152833938598633,
    -3.7443690299987793,
    -3.4361915588378906,
    -3.3979721069335938,
    -3.419360399246216,
    -3.4160542488098145,
    -3.4349420070648193,
    -3.4178519248962402,
    -3.3925697803497314,
    -3.4037301540374756,
    -3.414592981338501,
    -3.4126620292663574,
    -3.3844165802001953,
    -3.3755598068237305,
    -3.3856983184814453,
    -3.3648345470428467,
    -3.3638997077941895,
    -3.354735851287842,
    -3.3473174571990967,
    -3.333874464035034,
    -3.308683156967163,
    -3.3269121646881104,
    -3.3106002807617188,
    -3.3277246952056885,
    -3.335212230682373,
    -3.3216569423675537,
    -3.298945188522339,
    -3.3082399368286133,
    -3.316694498062134,
    -3.3138504028320312,
    -3.3010387420654297,
    -3.2907986640930176,
    -3.2839157581329346,
    -3.2907910346984863,
    -3.308617353439331,
    -3.2909467220306396,
    -3.2808995246887207,
    -3.290750741958618,
    -3.266937732696533,
    -3.267224073410034,
    -3.2624361515045166,
    -3.3050568103790283,
    -3.308621883392334,
    -3.300518035888672,
    -3.2891149520874023,
    -3.2790703773498535,
    -3.2750601768493652,
    -3.2744810581207275,
    -3.275308609008789,
    -3.2593469619750977,
    -3.2667782306671143,
    -3.296077251434326,
    -3.279280185699463,
    -3.2773728370666504,
    -3.2876179218292236,
    -3.278104782104492,
    -3.3016116619110107,
    -3.2702648639678955,
    -3.2659521102905273,
    -3.2766129970550537,
    -3.296738624572754,
    -3.3052926063537598,
    -3.3345372676849365,
    -3.323935031890869,
    -3.3411145210266113,
    -3.350952625274658,
    -3.364716053009033,
    -3.363351345062256,
    -3.331611394882202,
    -3.3105180263519287,
    -3.325976610183716,
    -3.279374361038208,
    -3.2716166973114014,
    -3.1616129875183105,
    -3.1023306846618652,
    -3.442901849746704,
    -3.541111707687378,
    -3.679525375366211,
    -3.711088180541992,
    -3.69928240776062,
    -3.687394618988037,
    -3.6920037269592285,
    -3.7030889987945557,
    -3.70644474029541,
    -3.7170307636260986,
    -3.730924129486084,
    -3.750009775161743,
    -3.7894279956817627,
    -3.7888729572296143,
    -3.786543607711792,
    -3.7741377353668213,
    -3.7586846351623535,
    -3.738259792327881,
    -3.567009925842285,
    -3.645210027694702,
    -3.779625415802002
  ]  
}

Volume inside a polygon

Get the volume of material a polygon in your plan. Assumes that object has no overhanging features, so most valuable for stockpiles, earth movement on construction sites, and quarry walls.

GET /v2/tiles/<plan_id>/volume/POLYGON((<lng> <lat>,<lng> <lat>,...,<lng> <lat>))

  • The plan_id can be obtained by listing your plans
  • lng lat is the longitude, latitude pairs of the corners of the polygon

 

Available Query Parameters:

1. baseplane_type

Valid values for baseplane_type:

  • fit(default)
  • triangulated
  • lowest
  • designSurface(requiresdifferenceparameter)
  • comparisonMap(requiresdifferenceparameter)
  • custom(requires numericcustom_elevationparameter)

 

2. tolerance

a. Optional

b. Numeric value

i. ex: 0.04 (4cm)

c. ex: curl "https://public-api.dronedeploy.com/v2/tiles/580fd790d5d264a5d8515a73/volume/POLYGON((-123.11442375183108%2038.42649805908029,-123.11435401439668%2038.42607780608576,-123.1135976314545%2038.42590129909882,-123.11349570751193%2038.426666159593374,-123.11442375183108%2038.42649805908029))?baseplane_type=fit&tolerance=0.04&api_key={api_key}"

 

3. difference

a. Optional

b. Only valid when  baseplane_type is designSurface or comparisonMap

c. Value must be the tile template url for the design surface or comparison map

d. ex: curl "https://public-api.dronedeploy.com/v2/tiles/580fd790d5d264a5d8515a73/volume/POLYGON((-123.11442375183108%2038.42649805908029,-123.11435401439668%2038.42607780608576,-123.1135976314545%2038.42590129909882,-123.11349570751193%2038.426666159593374,-123.11442375183108%2038.42649805908029))?baseplane_type=comparisonMap&difference=https://storage.domain.com/dronedeploy-tiles/4cc6f9fa6b_028567932EINSPIRE_COPY_dem_abc/{z}/{x}/{y}.tiff&api_key={api_key}"

 

4. custom_elevation

a. Optional

b. Only valid when baseplane_type is custom

c. Value must be numeric

d. ex: curl "https://public-api.dronedeploy.com/v2/tiles/580fd790d5d264a5d8515a73/volume/POLYGON((-123.11442375183108%2038.42649805908029,-123.11435401439668%2038.42607780608576,-123.1135976314545%2038.42590129909882,-123.11349570751193%2038.426666159593374,-123.11442375183108%2038.42649805908029))?baseplane_type=custom&custom_elevation=123.4&api_key={api_key}"

 

 

Returns JSON - Polygon Volume Object

curl "https://public-api.dronedeploy.com/v2/tiles/580fd790d5d264a5d8515a73/volume/POLYGON((-123.11442375183108%2038.42649805908029,-123.11435401439668%2038.42607780608576,-123.1135976314545%2038.42590129909882,-123.11349570751193%2038.426666159593374,-123.11442375183108%2038.42649805908029))?baseplane_type=fit&api_key={api_key}"

{  
  "baseplane_type": "fit", 
  "cut": 26153.559188015362, 
  "fill": -18900.181208767106, 
  "polygon": "POLYGON(6.535406112670899 46.655990545464206,6.5360498428344735 46.655710711675226,6.535298824310304 46.654561905156164,6.534655094146729 46.654723917810095,6.535406112670899 46.655990545464206)",
  "volume": 7253.377979248256 
}
REST API Announcement
The REST APIs in this documentation are our legacy APIs and no longer under active development. Please go to our API explorer page and our developer page for our new more capable GraphQL based APIs.

Articles in this section

Was this article helpful?
0 out of 0 found this helpful