---
name: "BIS_fnc_nearestRoad"
type: function
status: ok
groups: ["Positions"]
arma3_since: "0.76"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_nearestRoad
revid: 378228
updated: 2026-03-17T23:25:48Z
---

# BIS_fnc_nearestRoad

*Function · Positions · Arma 3 v0.76*

## Description

Find the nearest road segment to certain position, within given radius.

## Syntax

```sqf
[centre, radius, blacklist] call BIS_fnc_nearestRoad
```

**Parameters:**

- `centre`: [Position](../topics/Position.md)
- `radius`: [Number](../topics/Number.md) - (Optional, default 50) search radius from *centre*
- `blacklist`: [Array](../topics/Array.md) - (Optional, default `[]`) blacklisted road objects

**Returns:** [Object](../topics/Object.md) - nearest road object, [objNull](../commands/objNull.md) if not found

## Examples

### Example 1

```sqf
private _nearestRoad = [getPosATL player, 500] call BIS_fnc_nearestRoad;
```

### Example 2

```sqf
private _nearestRoad = [getPosATL vehicle player, 50, getPosATL vehicle player nearRoads 20] call BIS_fnc_nearestRoad;
```

## See also

[nearRoads](../commands/nearRoads.md) · [isOnRoad](../commands/isOnRoad.md) · [roadAt](../commands/roadAt.md) · [roadsConnectedTo](../commands/roadsConnectedTo.md)

<sub>Source: [BI Community Wiki — BIS fnc nearestRoad](https://community.bistudio.com/wiki/BIS_fnc_nearestRoad) (revision 378228).</sub>