DroneDeploy
Search…
CadOverlay
What is a Cad Overlay?
A Cad Overlay is a mechanism that allows to put an image on a map or plan.
Contents

CadOverlay.prepare

Overview
Prepares a new overlay (creates new id and returns it).
Example Call
1
dronedeployApi.CadOverlay.prepare();
Copied!
Example response
1
{
2
"id": "12ab34cd56ef78gh90ij12kl"
3
}
Copied!

CadOverlay.import

Overview
Import an overlay image directly from a third party source using a download url.
Example Call
1
const url = 'https://www.mysite.com/my-overlay-image.png';
2
// Configure any headers required by the download site
3
// NOTE: headers may not be needed if using a signed download url
4
const headers = {
5
"Authorization": "Bearer mysecretbearertoken",
6
"X-Custom": "custom-header-value-for-mysite",
7
};
8
const name = 'My Overlay Image Name'
9
const id = 'Id Of New Overlay (generated by prepare method)'
10
11
// Call the import function
12
// NOTE: headers, name and id are optional parameters
13
dronedeployApi.CadOverlay.import(url, headers, name, id);
Copied!
How to Use
This API will be most effective when used with the App Zone in the Overlay Selection dialog, but can also be used from the App Zone on the Data Page as well.
    1.
    Drag your plugin code into the desired App Zone
    2.
    Interact with your plugin UI to trigger your import call
    3.
    Following overlay download, the image will appear and can be named and positioned on the map
NOTE: This API supports the same file types for Overlays as the main DroneDeploy application:
    PDF
    PNG
    SVG
For more general information about Overlays, click here
Last modified 2yr ago