Send Location Message

Send geographic location coordinates to WhatsApp contacts via Evolution API

Send Location Message

Send a location message with latitude, longitude, and optional name and address to WhatsApp contacts or groups. The location will be displayed as a map pin in the chat.

Endpoint

POST /message/sendLocation/:instanceName

Path Parameters

instanceName · string · required

The name of your WhatsApp instance that you created

Request Body

number · string · required

The recipient’s WhatsApp number in international format (without + symbol)

Example: 5511999999999 for a Brazilian number

latitude · number · required

The latitude coordinate of the location

Example: -23.550520 (São Paulo, Brazil)

longitude · number · required

The longitude coordinate of the location

Example: -46.633308 (São Paulo, Brazil)

name · string · required

The name of the location or place

Example: Paulista Avenue

address · string · required

The full address of the location

Example: Av. Paulista, 1578 - Bela Vista, São Paulo - SP, Brazil

delay · integer

Delay before sending the message in milliseconds

Example: 1000 for 1 second delay

quoted · object

Quote a previous message by providing its key and message object

mentionsEveryOne · boolean

Mention all participants in a group

Default: false

mentioned · array

Array of phone numbers to mention. Each number should be a numeric string.

Example: ["5511999999999", "5511888888888"]

Response

key · object

Message key information

message · object

The sent message object containing the location data

messageTimestamp · string

Unix timestamp when the message was sent

status · string

Message status (e.g., “PENDING”, “SENT”)

Code Examples

cURL

curl -X POST https://your-api-url.com/message/sendLocation/my-instance \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_API_KEY" \
  -d '{
    "number": "5511999999999",
    "latitude": -23.550520,
    "longitude": -46.633308,
    "name": "Paulista Avenue",
    "address": "Av. Paulista, 1578 - Bela Vista, São Paulo - SP, Brazil"
  }'

const response = await fetch('https://your-api-url.com/message/sendLocation/my-instance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'apikey': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    number: '5511999999999',
    latitude: -23.550520,
    longitude: -46.633308,
    name: 'Paulista Avenue',
    address: 'Av. Paulista, 1578 - Bela Vista, São Paulo - SP, Brazil'
  })
});

const data = await response.json();
console.log(data);

import requests

url = 'https://your-api-url.com/message/sendLocation/my-instance'
headers = {
    'Content-Type': 'application/json',
    'apikey': 'YOUR_API_KEY'
}
payload = {
    'number': '5511999999999',
    'latitude': -23.550520,
    'longitude': -46.633308,
    'name': 'Paulista Avenue',
    'address': 'Av. Paulista, 1578 - Bela Vista, São Paulo - SP, Brazil'
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://your-api-url.com/message/sendLocation/my-instance',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode([
    'number' => '5511999999999',
    'latitude' => -23.550520,
    'longitude' => -46.633308,
    'name' => 'Paulista Avenue',
    'address' => 'Av. Paulista, 1578 - Bela Vista, São Paulo - SP, Brazil'
  ]),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'apikey: YOUR_API_KEY'
  ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Advanced Examples

Send location of a restaurant

{
  "number": "5511999999999",
  "latitude": 40.758896,
  "longitude": -73.985130,
  "name": "Times Square",
  "address": "Manhattan, NY 10036, United States"
}

Send location with mentions

{
  "number": "[e-mail]",
  "latitude": -23.550520,
  "longitude": -46.633308,
  "name": "Meeting Point",
  "address": "Av. Paulista, 1578 - Bela Vista, São Paulo - SP",
  "mentioned": ["5511888888888", "5511777777777"]
}

Send location as reply

{
  "number": "5511999999999",
  "latitude": 51.507351,
  "longitude": -0.127758,
  "name": "Big Ben",
  "address": "Westminster, London SW1A 0AA, UK",
  "quoted": {
    "key": {
      "id": "BAE5F2D3E4F5A6B7",
      "remoteJid": "[e-mail]",
      "fromMe": false
    },
    "message": {
      "conversation": "Where should we meet?"
    }
  }
}

Location Coordinates Guide

Latitude and longitude values must be valid geographic coordinates:

• Latitude: -90 to +90 (negative for South, positive for North)
• Longitude: -180 to +180 (negative for West, positive for East)

How to Get Coordinates

1. Google Maps:

   • Right-click on a location
   • Click on the coordinates to copy them
   • Format: latitude, longitude

2. GPS Devices:

   • Most GPS devices provide latitude and longitude
   • Ensure they’re in decimal format (not degrees/minutes/seconds)

3. Geolocation API:

   navigator.geolocation.getCurrentPosition((position) => {
     console.log('Latitude:', position.coords.latitude);
     console.log('Longitude:', position.coords.longitude);
   });
   

Coordinate Format Examples

City	Latitude	Longitude
New York, USA	40.7128	-74.0060
London, UK	51.5074	-0.1278
Tokyo, Japan	35.6762	139.6503
Sydney, Australia	-33.8688	151.2093
São Paulo, Brazil	-23.5505	-46.6333

Location Display in WhatsApp

When you send a location message:

1. Recipients see a map preview with a pin
2. The location name appears as a title
3. The address appears as a subtitle
4. Tapping the message opens the location in their default maps app
5. Recipients can get directions to the location

All four parameters (latitude, longitude, name, and address) are required. If any are missing, the API will return a 400 Bad Request error.

Error Responses

status · number

HTTP status code

message · string

Error description

Common Errors

Status Code	Error Message	Solution
400	Bad Request - Missing required fields	Ensure all required fields (number, latitude, longitude, name, address) are provided
400	Invalid latitude/longitude values	Check that coordinates are within valid ranges
401	Unauthorized	Check your API key
404	Not Found	Verify instance exists and is connected
500	Internal Server Error	Check server logs or contact support

Latitude and longitude should be sent as numbers, not strings. Ensure your JSON payload uses numeric types for these values.