---
title: "GetActorPos | open.mp"
description: "Obtenha a posição de um ator."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetActorPos
language: pt-BR
---

# GetActorPos

aviso

Esta função foi adicionada no SA-MP 0.3.7 e não funcionará em versões anteriores!

## Descrição

Obtenha a posição de um ator.

| Nome | Descrição |
| --- | --- |
| actorid | O ID do ator para obter a posição. Retornado por CreateActor. |
| &Float:x | Uma variável flutuante, passada por referência, na qual armazena a coordenada X do ator. |
| &Float:y | Uma variável flutuante, passada por referência, na qual armazenar a coordenada Y do ator. |
| &Float:z | Uma variável flutuante, passada por referência, na qual armazena a coordenada Z do ator. |

## Retornos

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

**false** - Falha na execução da função. O ator especificado não existe.

A posição do ator é armazenada nas variáveis especificadas.

## Exemplos

```c
new Float:x, Float:y, Float:z;
GetActorPos(actorid, x, y, z);
```

## Funções Relacionadas

-   [SetActorPos](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetActorPos): Define a posição de um ator.