Designs (Create and Get)

Once a project has been created, you can create a design on that project. Scanifly offers Design Services, that will be addressed in Service Requests.

Design Services

Create design on project id

Reference Link

Scanifly supports two types of designs:

  • Remote: Designs based on satellite imagery
  • On-Site: Designs based on photogrammetry generated by drone images

When creating a new design, you have the option to set which type of design you would like to create. If you do not pass a value, the "remote" value will default to "true', meaning, the design will be a remote design.

  • remote: true (Remote design based on satellite imagery)
  • remote: false (On-Site design based on drone imagery)

Sample Create design on project id call

Create Design on Project ID Call

Sample_Create design on project id_ response

When you receive the Create design response, you should store the id value in your system so that you can make subsequent calls to retrieve design specific data and media files.

The Create design on project id response will also include the 'designUrl'. This can be stored in your system so that your team can click a the link from your CRM and open the design in Scanifly, eliminating clicks to navigate to the project and design.


Create Design on Project ID Response

Syncing Designs (Get designs by project id and Get designs by design id)

You have two calls available to retrieve design data.

"Get designs by project id" will return all designs associated with a project. This is useful if rely on multiple design versions in your workflow.

"Get designs by design id" narrows the response to the one design that you are interested in syncing.

There are a few things to keep in mind when examining and parsing the data:

  • The shadeReport Url will only be populated if a user has done the following in Scanifly:
    • Generated the shade report
    • Clicked the Export to API button

Export to API Button
  • The shareLinkUrl will only be populated if a user has filled out and clicked the Share button on the 'Share' information tab on the design.

Share Button

Data in_Get designs by project id / design id _ response

There is a significant amount of data passed in the Get design calls. For the best experience, please go to the API doc and submit a test request to see the full response. This is a brief overview (does not include all fields in response) of the data that you are able to extract from the response.

FieldDescription
systemSizeProduction for whole system
ASAAnnual Solar Access
annualProductionAnnual production for all segments combined
shadeReportUrlShade report URL will be populated if a user has generate shade analysis this in Scanifly
hourlyProductionUrlLink to the system hourly production report
hourlyProductSegmentUrlsLinks to the hourly production by segments report
projectInfoReportIncludes project info, nearest weather station info and distance to weather station
systemOverviewIncludes segment count, module quantity, estimated production, annual consumption, System offset, roof surface area, etc
dxf2DWireframeUrlURL to 2D design file location
dxf3DWireframeUrlURL to 3D design file location
segmentInfoIncludes module type, quantity, arraySize, estimated production, systemLosses, monthlyAsa, etc.
monthlyBreakdownProduction and Consumption by month