# getClosestStraightRoad (Compartilhado)

> Acha o trecho de rua mais perto de um ponto: dois nós de carro ligados e a direção entre eles. Nós desligados ficam de fora.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Ruas e caminhos
- **URL**: https://wiki.mymp.gg/pt/getClosestStraightRoad

## Sintaxe

```lua
vec3, vec3, float|false getClosestStraightRoad(float x, y, z [, float minLength = 0, float maxDistance = 999999.875])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `x, y, z` | `float` | O ponto de onde procurar. |
| `minLength` | `float` | Distância mínima em metros entre os dois nós. *(padrão: `0`)* |
| `maxDistance` | `float` | Até que distância do ponto o trecho pode estar. *(padrão: `999999.875`)* |

## Retorno

A posição dos dois nós, ao lado do canteiro como `getPathNodePosition` com `lane`, e a direção do segundo para o primeiro em graus. `false` se nenhum trecho foi achado.

## Exemplo

```lua
local vehicle = getPedOccupiedVehicle(localPlayer)
if vehicle then
    local position = getElementPosition(vehicle)
    local first, second, heading = getClosestStraightRoad(position.x, position.y, position.z, 10, 200)
    if first then
        setElementPosition(vehicle, first.x, first.y, first.z + 1)
        setElementRotation(vehicle, 0, 0, heading)
    end
end
```

### Atenção

Só contam os nós das áreas de caminho carregadas: as que estão perto do jogador ou foram pedidas com `requestPathNodesInArea`.

## Veja também

- [getClosestPathNode (Compartilhado)](https://wiki.mymp.gg/pt/getClosestPathNode.md): Acha o nó de rua ou de calçada mais perto de um ponto.
- [getPathNodePosition (Compartilhado)](https://wiki.mymp.gg/pt/getPathNodePosition.md): Devolve a posição de um nó de caminho.