POST/api/v1/e6b/crosswind/calculateCommercial Pilot

Calculate Crosswind

Calculates crosswind and headwind components from manually provided wind and runway heading values.

Code Examples

curl \
  -X POST \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "windDirectionDegrees": 230,
  "windSpeedKt": 15,
  "windGustKt": 22,
  "runwayHeadingDegrees": 180
}' \
  "https://api.preflightapi.io/api/v1/e6b/crosswind/calculate"

curl \
  -X POST \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "windDirectionDegrees": 230,
  "windSpeedKt": 15,
  "windGustKt": 22,
  "runwayHeadingDegrees": 180
}' \
  "https://api.preflightapi.io/api/v1/e6b/crosswind/calculate"

Description

Provide wind direction, wind speed, and a runway heading to compute the headwind and crosswind components. Optionally include a gust speed to also compute gust components.

Sign Conventions

CrosswindKt — positive = wind from the right, negative = wind from the left

HeadwindKt — positive = headwind (favorable), negative = tailwind (unfavorable)

Request BodyCrosswindCalculationRequestDto

windDirectionDegreesintegernullable

Wind direction in degrees (0-360, or null for variable)

windSpeedKtinteger

Wind speed in knots

windGustKtintegernullable

Wind gust speed in knots (optional)

runwayHeadingDegreesinteger

Runway heading in magnetic degrees (0-360)

Response Schema

200Returns the calculated crosswind and headwind componentsCrosswindCalculationResponseDto

crosswindKtnumber

Crosswind component in knots. Positive = from the right, Negative = from the left

headwindKtnumber

Headwind component in knots. Positive = headwind, Negative = tailwind

gustCrosswindKtnumbernullable

Crosswind component from gusts in knots (if gust data provided). Positive = from the right

gustHeadwindKtnumbernullable

Headwind component from gusts in knots (if gust data provided). Positive = headwind

windDirectionDegreesintegernullable

Wind direction used in calculation (degrees)

windSpeedKtinteger

Wind speed used in calculation (knots)

windGustKtintegernullable

Wind gust speed used in calculation (knots)

runwayHeadingDegreesinteger

Runway heading used in calculation (degrees)

isVariableWindboolean

Whether the wind was reported as variable (VRB)

400The request parameters are invalid (e.g., wind speed is negative)ApiErrorResponse

codestring

Machine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").

messagestring

Human-readable error message suitable for display.

detailsstringnullable

Additional error details (only included in development environment).

servicestringnullable

Name of the external service that failed (only included for 503 errors).

validationErrorsRecord<string, string[]>nullable

Field-level validation errors (only for validation failures).

timestampstring

UTC timestamp when the error occurred.

traceIdstringnullable

Correlation ID for tracing the request.

pathstringnullable

Request path that generated the error.