sendLocation

Use this method to send a location to a chat (user, group, or channel). The location is represented by latitude and longitude coordinates, along with optional details.

Field	Type	Required	Description
`method`	String	Yes	`"sendMessage"`
`app_id`	String	Yes	App Id to which the message belongs.
`chat_id`	String	Yes	Unique identifier for the target Chat or User_id.
`to_user_id`	String	Optional	Unique identifier of the target user. If the user replies or sends a message to the target user, it will be displayed within a Group or Channel.
`longitude`	String	Yes	Longitude coordinate of the location.
`latitude`	String	Yes	Latitude coordinate of the location.
`name`	String	Optional	Name of the location (e.g., venue, city, landmark).
`details`	String	Optional	Additional details about the location.
`reference`	Long	Yes	Unique local identifier for the message.
`reply_to_message_id`	String	Optional	Unique identifier for the original parent message. Use it when the message is a reply.
`echo`	Integer	Optional	If set to `1`, returns a copy of the message to the sender. Default is `0`.
`disable_web_page_preview`	Boolean	Optional	Disables link previews for links in this message.
`disable_notification`	Boolean	Optional	Sends the message silently; users will receive a notification with no sound.
`menu_ref`	String	Optional	Menu reference for an existing predefined menu: The menu will be displayed as an inline menu associated with the message.
`inline_menu`	Array of Menu	Optional	Inline menu object to hold menus. If both `inline_menu` and `menu_ref` are defined, the priority goes to inline_menu.
`chat_settings`	Integer	Optional	Administrators can chat with the bot privately, unlike normal users. In settings, the Bot Manager section allows admins to send commands. Setting `chat_settings=1` reroutes messages to the Bot Manager for administrative communication.

Preconditions for API Functionality

The following tables outline the preconditions that must be met for the API to function correctly. Failure to meet these conditions may result in errors or unexpected behavior.

Preconditions for API permissions

Before sending or replying to a message, ensure the following conditions are met:

Action	Required Permission	Description
Sending a message	`"Send Message"`	The API must have the `"Send Message"` permission to send messages in a chat (user, group, or channel).
Replying to a specific message	`"Reply to Message"`	The user must have the `"Reply to Message"` permission to respond to a specific message within a chat.

Preconditions for API Role in the Chat

Before sending messages, the API must meet the following status requirements based on the type of chat:

Chat Type	Required API Role	Description
User Chat	User Pre-Joined	The user must have pre-joined (started) the API (bot) before receiving messages.
Group Chat	Member	The API must be a member of the group to send messages.
Channel	Admin	The API must be an admin in the channel to send messages.

Response

✅ The messageAck method is always returned on success.

If echo = 1, → An additional response is returned with the message method, containing a copy of the sent message object.

Example:

Requests

json
 {
    "method": "sendLocation",
    "chat_id": "90090684438172188",
    "reference": 111111146,
    "latitude": "45.3178",
    "longitude": "-75.6659",
    "name": "Ottawa International Airport",
    "details": "International Airport",
    "app_id": "90090684293000559",
    "echo": 1
}

java

if (incomingMsg.getText().toLowerCase().equals("location")) {
	LocationOutMessage locMsg = new LocationOutMessage();
	locMsg.setChatId(incomingMsg.getChat().getId());
	locMsg.setReference(Utils.getUniqueId());
	locMsg.setName("Ottawa International Airport");
	locMsg.setDetails("International Airport");
	locMsg.setLatitude("45.3178");
	locMsg.setLongitude("-75.6659");
	locMsg.setCaption("My Caption");
	api.send(locMsg);
}

javascript
let locationOutMsg = new LocationOutMessage();
locationOutMsg.chat_id = incomingMsg.chat.id;
locationOutMsg.reference = Id();
locationOutMsg.name = incomingMsg.location.name;
locationOutMsg.details = incomingMsg.location.details;
locationOutMsg.latitude = incomingMsg.location.latitude;
locationOutMsg.longitude = incomingMsg.location.longitude;
locationOutMsg.caption = "My Captian";

api.send(JSON.stringify(locationOutMsg));

python

napi.send_location("chatId","Lat","Lng",Utils.get_unique_id())

Responses

json
{
    "method": "messageAck",
    "ack": {
        "reference": 111111146,
        "date": 1741983193944,
        "gmid": 24,
        "message_id": "d1_PjZpr6mX126266"
    }
}

json
{
    "method": "message",
    "message": {
        "date": 1741983193944,
        "reference": 111111146,
        "gmid": "24",
        "chat": {
            "id": "90090684438172188",
            "title": "New Chat",
            "type": "Group"
        },
        "message_id": "d1_PjZpr6mX126266",
        "style": 0,
        "from": {
            "name": "My First API",
            "id": "90091783822039252",
            "terminal": "API",
            "type": "Bot",
            "version": "('0w78')"
        },
        "location": {
            "latitude": "45.3178",
            "name": "Ottawa International Airport",
            "details": "International Airport",
            "longitude": "-75.6659"
        },
        "type": "location"
    },
            "app_id": 90090684293000559

}