Skip to main content
POST
/
shadingscenes
/
{scene_id}
/
trackinginputs
Upload Tracking Inputs
curl --request POST \
  --url https://api.example.com/shadingscenes/{scene_id}/trackinginputs

​
POST /shadingscenes//trackinginputs

Save single-axis tracker parameters and link them to the specified shading scene. These parameters control backtracking behavior and terrain-aware tracking adjustments used during shading simulation.

​
Notes

  • Content type is application/x-www-form-urlencoded.
  • gcr (Ground Coverage Ratio) is the only required field. All other parameters have sensible defaults.
  • Default parameter values:
    • azimuth: 0.0
    • axis_tilt: 0.0
    • back_tracking: true
    • max_angle: 60.0
    • terrain_aware: false
  • terrain_aware_diode_threshold and terrain_aware_method are only relevant when terrain_aware is true.
  • On success, returns the new trackingInputId and the associated shadingSceneId.
  • Returns 404 if the scene does not exist in the current workspace.
  • Requires write-level workspace access.
  • After uploading new tracking inputs, use POST /shadingscenes//refresh to re-run shading with the updated tracker configuration.