AIRAC API Documentation

Router Parser

Parse a route string, calculating distances and bearings between waypoints.

Query Parameters:

Parameter	Type	Required	Description
origin	string	✓	Origin airport ICAO code (4 letters)
destination	string	✓	Destination airport ICAO code (4 letters)
route	string	✓	Route string (max 2000 characters)
departure_runway	string		Departure runway (e.g., 07R, 25L). Optional but recommended for proper SID selection
arrival_runway	string		Arrival runway (e.g., 27L, 09R). Optional but recommended for proper STAR selection

Supported Route Elements:

• Waypoints: 2-5 letter identifiers (e.g., DOTSS, CIVET)
• Airways: Letter followed by numbers (e.g., J5, V23, Q822) - automatically expanded to include all intermediate waypoints
• Coordinates: Lat/Lon in format DDNDDW (e.g., 51N020W) or DDMMN/DDDMMW
• SID/STAR procedures: Alphanumeric identifiers (e.g., OBOK3D, LOGA2H) - automatically expanded to include all procedure waypoints
• NAT Tracks: NAT followed by letter or number (e.g., NATA, NATB, NAT1)

Route Processing Features:

• Airway Expansion: Airways are automatically expanded to show all intermediate waypoints between entry and exit points
• SID/STAR Expansion: Procedures are expanded to show all waypoints in the departure/arrival routing
• Runway Transitions: When departure/arrival runways are provided, appropriate runway-specific transitions are selected for SIDs/STARs
• Duplicate Removal: Consecutive duplicate waypoints are automatically removed
• Distance & Bearing: Calculates great circle distance (nm) and true bearing between each waypoint pair

Example Request:

GET /api/v1/routes/parse?origin=EDDF&destination=EGLL&route=OBOK3D%20OBOKA%20Z29%20TORNU%20BREDA%20ABNED%20L980%20LOGAN%20LOGA2H&departure_runway=07C&arrival_runway=09L

Example Response:

{
    "status": "success",
    "data": {
        "origin": "EDDF",
        "destination": "EGLL",
        "total_distance": 410.2,
        "segments": [
            {
                "from": {
                    "identifier": "EDDF",
                    "name": "Frankfurt/Main",
                    "type": "airport",
                    "coordinates": {
                        "lat": 50.033333,
                        "lon": 8.570556
                    }
                },
                "to": {
                    "identifier": "DF08C",
                    "name": "DF08C",
                    "type": "waypoint",
                    "coordinates": {
                        "lat": 50.049167,
                        "lon": 8.628056
                    },
                    "via": "OBOK3D"
                },
                "distance": 3.2,
                "bearing": 070,
                "cumulative_distance": 3.2
            },
            {
                "from": {
                    "identifier": "DF08C",
                    "name": "DF08C",
                    "type": "waypoint",
                    "coordinates": {
                        "lat": 50.049167,
                        "lon": 8.628056
                    }
                },
                "to": {
                    "identifier": "DF149",
                    "name": "DF149",
                    "type": "waypoint",
                    "coordinates": {
                        "lat": 50.142778,
                        "lon": 8.696111
                    },
                    "via": "OBOK3D"
                },
                "distance": 7.2,
                "bearing": 035,
                "cumulative_distance": 10.4
            },
            // ... additional segments showing expanded SID waypoints, airway waypoints, and STAR waypoints ...
        ],
        "errors": []
    }
}

Note: Errors are non-blocking. The navlog will still be generated for valid segments.

Error Types:

• airport_not_found - Origin or destination airport not found (critical error)
• waypoint_not_found - Waypoint identifier not found in database
• airway_not_found - Airway identifier not found
• airway_endpoints_not_found - Entry or exit waypoints for airway not specified
• waypoints_not_on_airway - Entry/exit waypoints not found on specified airway
• procedure_not_found - SID/STAR procedure not found at airport
• procedure_no_segments - Procedure found but has no route segments
• procedure_waypoint_not_found - Waypoint in procedure could not be resolved
• nat_track_not_supported - NAT tracks are not currently supported