{"name":"BIS_fnc_nearestRoad","title":"BIS fnc nearestRoad","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_nearestRoad","revid":378228,"updated":"2026-03-17T23:25:48Z","groups":["Positions"],"status":"ok","games":{"arma3":"0.76"},"since":"arma3 0.76","arma3_since":"0.76","description":"Find the nearest road segment to certain position, within given radius.","syntaxes":[{"syntax":"[centre, radius, blacklist] call BIS_fnc_nearestRoad","params":[{"name":"centre","type":"Position","type_expr":"Position"},{"name":"radius","type":"Number","optional":true,"default":"50","description":"search radius from *centre*","type_expr":"Number","text":"radius: Number - (Optional, default 50) search radius from *centre*"},{"name":"blacklist","type":"Array","optional":true,"default":"`[]`","description":"blacklisted road objects","type_expr":"Array","text":"blacklist: Array - (Optional, default `[]`) blacklisted road objects"}],"returns":{"type":"Object","type_expr":"Object","description":"nearest road object, objNull if not found"}}],"examples":[{"code":["private _nearestRoad = [getPosATL player, 500] call BIS_fnc_nearestRoad;"]},{"code":["private _nearestRoad = [getPosATL vehicle player, 50, getPosATL vehicle player nearRoads 20] call BIS_fnc_nearestRoad;"]}],"see_also":["nearRoads","isOnRoad","roadAt","roadsConnectedTo"]}