Combined list of maps and flight plans
This API is usually the starting point for finding exports, tile templates and taking measurements programmatically. It provides information about all plans or a particular plan.First, you will need an API Key
List all plans
In order to list all plans available in your account, send a GET request to /v2/plans
.
This will fetch the first page of 50 plans. To request more, see API Pagination
GET /v2/plans
Returns JSON - List of all plans and associated metadata
curl "https://public-api.dronedeploy.com/v2/plans?api_key={api_key}"
[
{
"log": "EXAMPLE_000002",
"id": "5605c0e5752afc005a000004",
"location": {
"lat": 35.92596388888889,
"lng": -96.74810972222222
},
"image_count": 66,
"date_creation": 1377012456330,
"latest_started_map": {
"user_status": "Complete"
},
"name": "Construction Example"
},
{
"log": "EXAMPLE_000001",
"id": "56048e63752afc0058000001",
"location": {
"lat": 48.60367083333334,
"lng": -97.21722638888889
},
"image_count": 301,
"date_creation": 1372605078006,
"latest_started_map": {
"user_status": "Complete"
},
"name": "Agriculture Example"
}
]
Content-Type: application/json
Content-Length: 793
Connection: keep-alive
Date: Fri, 14 Oct 2016 04:15:03 GMT
x-amzn-RequestId: c78a0f54-91c4-11e6-83fa-4b04143ff153
X-Cache: Miss from cloudfront
Via: 1.1 ebc28fb0ad14691ee5d6c1a49f41b878.cloudfront.net (CloudFront)
X-Amz-Cf-Id: fkzjbF0UPmUOh9iQMT0PHY6pnBji5AJV1Qh9ol45m9fTsXMC4DAeoQ==
Get all data for a specific plan
To get all data for a specific plan in your account.
GET /v2/plans/<planid>
- The
plan_id
can be obtained by listing all plans (above)
Returns JSON - Detailed plan metadata and links
curl "https://public-api.dronedeploy.com/v2/plans/5605c0e5752afc005a000004?api_key={api_key}"
{
"log": "EXAMPLE_000002",
"id": "5605c0e5752afc005a000004",
"location": {
"lat": 35.92596388888889,
"lng": -96.74810972222222
},
"image_count": 66,
"date_creation": 1377012456330,
"latest_started_map": {
"user_status": "Complete"
},
"name": "Construction Example"
}
{
"polygon": "POLYGON((6.535406112670899 46.655990545464206,6.5360498428344735 46.655710711675226,6.535298824310304 46.654561905156164,6.534655094146729 46.654723917810095,6.535406112670899 46.655990545464206))",
"baseplanetype": "fit",
"cut": 26153.559188015362,
"fill": -18900.181208767106,
"volume": 7253.377979248256
}
Date: Fri, 14 Oct 2016 04:17:36 GMT
Content-Type: application/json
Content-Length: 260
Connection: keep-alive
x-amzn-RequestId: 2290d306-91c5-11e6-8b95-15fd70d0da6c
X-Cache: Miss from cloudfront
Via: 1.1 8b5947aba7280333032d4dcdd80b3489.cloudfront.net (CloudFront)
X-Amz-Cf-Id: v7w995uifC15ZuSfGx9L1861FiReDSfAXDVTlTrAc25Wx9KUCfHWHw==
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.