added land

API.md

@@ -20,6 +20,8 @@
 - Частота в HTTP API: `frequency_mhz`.
 - DEM берётся из `DEM_PATH`, по умолчанию `/data/dem`.
 - Buildings берутся из PostGIS table `buildings`.
+- Vegetation loss считается по формуле P.833 с коэффициентами из env:
+  `P833_GAMMA_DB_PER_M` и `P833_MAX_ATTENUATION_DB`.
 
 ## Health
 
@@ -132,6 +134,7 @@ curl -s -X POST http://localhost:5603/api/v1/terrain/profile \
   "fresnel_clearance": 0.6,
   "include_buildings": true,
   "include_canopy": false,
+  "include_vegetation": true,
   "k_factor": 1.333,
   "samples": 128
 }
@@ -149,6 +152,7 @@ curl -s -X POST http://localhost:5603/api/v1/terrain/los \
     "fresnel_clearance": 0.6,
     "include_buildings": true,
     "include_canopy": false,
+    "include_vegetation": true,
     "k_factor": 1.333,
     "samples": 128
   }' | jq '{
@@ -158,7 +162,8 @@ curl -s -X POST http://localhost:5603/api/v1/terrain/los \
     geometric_obstructions_count,
     building_obstructions_count,
     worst_obstruction,
-    diffraction_loss_db
+    diffraction_loss_db,
+    vegetation_loss_db
   }'
 ```
 
@@ -174,6 +179,7 @@ curl -s -X POST http://localhost:5603/api/v1/terrain/los \
 - `building_obstructions_count`: количество геометрических препятствий типа `building`.
 - `worst_obstruction`: худшая точка по запасу относительно требуемого Fresnel clearance.
 - `diffraction_loss_db`: текущая Bullington-style оценка knife-edge loss.
+- `vegetation_loss_db`: P.833 attenuation по `vegetation_depth_m` из WorldCover, если `include_vegetation=true`.
 
 Поля obstruction:
 
@@ -261,6 +267,10 @@ curl -s -X POST http://localhost:5603/api/v1/link/budget \
 - `fresnel_clear`
 - `link_viable`
 
+При `include_vegetation=true` API сэмплит WorldCover вдоль трассы и добавляет
+P.833 vegetation attenuation в `vegetation_db`. Если landcover raster отсутствует,
+значение остаётся `0`, чтобы link budget продолжал работать.
+
 Модели `p452` и `itm` пока возвращают `501 Not Implemented`.
 
 ## Antenna