Terrain-derived analysis

Free. Two computations derived from the Copernicus DEM GLO-30, both returned from a single read. operation=sar_geometry over a bbox, with incidence_deg and look_azimuth_deg, returns the share of the area lost to LAYOVER and SHADOW, the share merely foreshortened, and the mean local incidence angle — the arithmetic behind whether radar can actually use that ground, which changes with the pass direction and must not be assumed. operation=profile between two points returns the ground along the line and a LINE-OF-SIGHT verdict including Earth curvature: where the terrain first rises above the sight line, and by how much at worst. Both state the sample spacing they were computed at, because a coarser grid reads flatter and therefore more observable than the ground is. A SURFACE model, so canopy and buildings are included. Cite the returned attribution.

get/api/v1/terrain

Request

  • Base URL: https://offnadir-delta.com
  • URL: https://offnadir-delta.com/api/v1/terrain
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

operation'sar_geometry' | 'profile' required

Which computation to run.

bboxstring

For sar_geometry: area as "lon_min,lat_min,lon_max,lat_max" (WGS84).

incidence_degnumber

For sar_geometry: sensor incidence angle. Sentinel-1 IW spans roughly 29-46 degrees.

look_azimuth_degnumber

For sar_geometry: compass bearing the sensor looks along the ground range. A right-looking descending pass looks roughly west (270).

latnumber

For profile: latitude of the observer end.

lonnumber

For profile: longitude of the observer end.

to_latnumber

For profile: latitude of the far end.

to_lonnumber

For profile: longitude of the far end.

observer_height_mnumber

For profile: eye height above the ground, default 2 m. Use the real mast or tower height when that is the question.

Response

The requested terrain computation.

operationstring
sar_geometryobject

Present for operation=sar_geometry.

profileobject

Present for operation=profile, including line_of_sight.

attributionstring

Changes

No recorded changes to this operation across all 1 revision of this API.