screen_corridor
Screen a corridor for a vehicle profile: pass a route polyline as points (array of {lat, lon} objects tracing the actual road — submit a real route trace, not city points) plus a vehicle height and weight, and get back every bridge near the corridor that fails the profile, fails first then warnings, each nearest first with distance_km. Read-only: it checks data, it changes nothing. Height: pass one of height_ft or height_m. Weight: pass one of weight_lbs or weight_t (compared against the bridge operating rating in metric tons). buffer_km defaults to 2 (max 25) and sets how far from the polyline a bridge counts. pad_ft/pad_m (default 6 in) is added to the height before the clearance test. Fails: clearance below height plus pad (under-bridge clearance), posted below weight, closed, not yet open. Warnings, not failures: poor condition, unknown rating, unknown clearance. limit defaults to 100 (max 500); fails come first, warnings fill the remainder. Returns fails and warns arrays with fail_count and warn_count totals. Use this instead of find_bridges_nearby when you have a corridor, not a point, and instead of find_low_clearance_bridges when you have a full vehicle profile, not just a height threshold. This is a buffered-polyline screen, not a router: it does not produce directions. Data is the FHWA NBI 2025 annual snapshot, not live status, and bridges with no coordinates are excluded.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results returned, fails first then warnings, at most 500 | |
| pad_m | No | Safety pad added to the height before the clearance test, in meters (default 0.15) | |
| pad_ft | No | Safety pad added to the height before the clearance test, in feet (default 6 in) | |
| points | Yes | Route polyline tracing the actual road, as {lat, lon} points in decimal degrees (at least 2, at most 50). Submit a real route trace, not city points. | |
| height_m | No | Vehicle height in meters, e.g. 4.11 — alternative to height_ft, pass one, not both | |
| weight_t | No | Vehicle gross weight in metric tons — alternative to weight_lbs, pass one, not both | |
| buffer_km | No | Corridor half-width in km: bridges within this distance of the polyline count, greater than 0 and at most 25 | |
| height_ft | No | Vehicle height in feet, e.g. 13.5 — alternative to height_m, pass one, not both | |
| weight_lbs | No | Vehicle gross weight in pounds, e.g. 80000 — alternative to weight_t, pass one, not both |