{"name":"nearRoads","operator":null,"title":"nearRoads","type":"command","url":"https://community.bistudio.com/wiki/nearRoads","revid":377410,"updated":"2026-01-02T06:45:12Z","groups":["Roads and Airports","Object Detection"],"status":"ok","replaced_by":[],"games":[{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma2","name":"Arma 2","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Find the road segments within the circle of given radius.","syntaxes":[{"syntax":"pos nearRoads radius","since":null,"effect":null,"exec":null,"params":[{"name":"pos","type":"Object or PositionAGL or Position2D","optional":false,"default":null,"description":"center of search radius","types":["Object","PositionAGL","Position2D"],"since":null,"text":"pos: Object or PositionAGL or Position2D - center of search radius"},{"name":"radius","type":"Number","optional":false,"default":null,"description":"search radius in meters","types":["Number"],"since":null,"text":"radius: Number - search radius in meters"}],"returns":{"type":"Array of Objects","types":["Array","Object"],"description":"road segments within radius","text":"Array of Objects - road segments within radius"},"form":"binary","operator":null,"left":{"text":"pos","types":["Object","PositionAGL","Position2D"]},"right":{"text":"radius","types":["Number"]}}],"examples":[{"text":"```sqf\n_list = player nearRoads 50;\n```","code":["_list = player nearRoads 50;"]},{"text":"```sqf\n_list = (position _unit) nearRoads 50;\n```","code":["_list = (position _unit) nearRoads 50;"]},{"text":"```sqf\n_list = [1800,5700] nearRoads 50;\n```","code":["_list = [1800,5700] nearRoads 50;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["isOnRoad","roadAt","surfaceIsWater","roadsConnectedTo","findNearestEnemy","nearestBuilding","nearestObject","nearestObjects","nearObjects","nearestLocation","nearEntities","nearTargets","nearSupplies","nearestLocationWithDubbing","nearObjectsReady","getRoadInfo","nearestTerrainObjects","nearestMines"],"notes":[],"categories":["Arma 2: New Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Object Detection","Command Group: Roads and Airports","Introduced with Arma 2 version 1.00","Scripting Commands","Take On Helicopters: Scripting Commands"]}