---
title: "GetVehicleVelocity | open.mp"
description: "Obtenha a velocidade de um veículo nos eixos X, Y e Z."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetVehicleVelocity
language: pt-BR
---

# GetVehicleVelocity

## Descrição

Obtenha a velocidade de um veículo nos eixos X, Y e Z.

| Nome | Descrição |
| --- | --- |
| vehicleid | O ID do veículo cuja velocidade será obtida. |
| &Float:x | Uma variável float na qual armazenar a velocidade X do veículo, passada por referência. |
| &Float:y | Uma variável flutuante na qual armazenar a velocidade Y do veículo, passada por referência. |
| &Float:z | Uma variável flutuante na qual armazenar a velocidade Z do veículo, passada por referência. |

## Retornos

**true** - A função foi executada com sucesso.

**false** - Falha na execução da função. Isso significa que o veículo especificado não existe.

A velocidade do veículo é armazenada nas variáveis especificadas.

## Exemplos

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp("/GetMyCarVelocity", cmdtext))
    {
        if (!IsPlayerInAnyVehicle(playerid))
        {
            return 1;
        }

        new
            Float: vehVelocity[3],
            string[128];

        GetVehicleVelocity(GetPlayerVehicleID(playerid), vehVelocity[0], vehVelocity[1], vehVelocity[2]);

        format(string, sizeof(string), "You are going at a velocity of X%f, Y%f, Z%f", vehVelocity[0], vehVelocity[1], vehVelocity[2]);
        SendClientMessage(playerid, 0xFFFFFFFF, string);
        return 1;
    }
    return 0;
}
```

## Notas

dica

Esta função pode ser usada para recuperar a velocidade de um veículo (km/h, m/s ou mph).

## Funções Relacionadas

-   [SetVehicleVelocity](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetVehicleVelocity): Defina a velocidade de um veículo.
-   [SetPlayerVelocity](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetPlayerVelocity): Define a velocidade de um jogador.
-   [GetPlayerVelocity](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPlayerVelocity): Obtenha a velocidade de um jogador.