> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Localização

> Envia uma localização no mapa

Envia uma localização geográfica para um contato ou grupo.

## Request Body

<ParamField body="sessionId" type="string" required>
  ID da sessão que enviará a mensagem.
</ParamField>

<ParamField body="to" type="string" required>
  Destinatário (número com DDI ou JID).
</ParamField>

<ParamField body="latitude" type="number" required>
  Latitude da localização.

  **Exemplo:** `-23.550520`
</ParamField>

<ParamField body="longitude" type="number" required>
  Longitude da localização.

  **Exemplo:** `-46.633308`
</ParamField>

<ParamField body="name" type="string">
  Nome do local.

  **Exemplo:** `"Av. Paulista, 1578"`
</ParamField>

<ParamField body="address" type="string">
  Endereço completo.

  **Exemplo:** `"Bela Vista, São Paulo - SP, 01310-200"`
</ParamField>

<ParamField body="quoted" type="object">
  Responder a uma mensagem específica.
</ParamField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/messages/location" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "to": "5511999999999",
      "latitude": -23.550520,
      "longitude": -46.633308,
      "name": "MASP - Museu de Arte de São Paulo",
      "address": "Av. Paulista, 1578 - Bela Vista, São Paulo"
    }'
  ```

  ```typescript TypeScript theme={"system"}
  const message = await client.messages.sendLocation(sessionId, {
    to: '5511999999999',
    latitude: -23.550520,
    longitude: -46.633308,
    name: 'MASP - Museu de Arte de São Paulo',
    address: 'Av. Paulista, 1578 - Bela Vista, São Paulo',
  });
  ```

  ```python Python theme={"system"}
  message = client.messages.send_location(
      session_id,
      to='5511999999999',
      latitude=-23.550520,
      longitude=-46.633308,
      name='MASP - Museu de Arte de São Paulo',
      address='Av. Paulista, 1578 - Bela Vista, São Paulo'
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "messageId": "3EB0ABC123DEF456789GHI",
    "status": "sent",
    "to": "5511999999999@s.whatsapp.net",
    "timestamp": "2024-01-15T10:30:00.000Z"
  }
  ```

  ```json 400 Bad Request theme={"system"}
  {
    "statusCode": 400,
    "error": "VALIDATION_ERROR",
    "message": "Coordenadas inválidas"
  }
  ```
</ResponseExample>

## Como o Destinatário Vê

A mensagem de localização mostra:

* Preview do mapa com pin
* Nome do local (se informado)
* Endereço (se informado)
* Botão "Abrir no Maps" que redireciona para Google Maps/Apple Maps

<Note>
  Se `name` e `address` não forem informados, será exibido apenas o mapa com as coordenadas.
</Note>