sendLocation
Надсилає геопозицію.
Повертає: У разі успіху повертає Message.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
business_connection_id | String | Ні | ID бізнес-підключення |
chat_id | Integer or String | Ні | ID чату або @username |
message_thread_id | Integer | Ні | ID теми форуму |
direct_messages_topic_id | Integer | Ні | ID теми особистих повідомлень (Bot API 10.0) |
ephemeral_message_parameters | EphemeralMessageParameters | Ні | JSON-об’єкт EphemeralMessageParameters — ефемерне повідомлення, яке бачить лише один користувач (Bot API 10.3) |
latitude | Float | Так | Широта |
longitude | Float | Так | Довгота |
horizontal_accuracy | Float | Ні | Точність у метрах (0-1500) |
live_period | Integer | Ні | Тривалість трансляції геопозиції в секундах (60-86400) |
heading | Integer | Ні | Напрямок руху в градусах (1-360) |
proximity_alert_radius | Integer | Ні | Радіус сповіщення про наближення (1-100000) |
disable_notification | Boolean | Ні | Надіслати без звуку |
protect_content | Boolean | Ні | Захистити вміст |
allow_paid_broadcast | Boolean | Ні | Дозволити платну розсилку |
message_effect_id | String | Ні | ID ефекту повідомлення |
suggested_post_parameters | SuggestedPostParameters | Ні | JSON-об’єкт SuggestedPostParameters (для каналів) |
reply_parameters | ReplyParameters | Ні | JSON-об’єкт ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | Ні | JSON: InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
Приклад запиту
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendLocation" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"latitude":51.5007,"longitude":-0.1246}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendLocation",
json={
"chat_id": 123456789,
"latitude": 51.5007,
"longitude": -0.1246
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendLocation`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"latitude": 51.5007,
"longitude": -0.1246
}),
});
console.log(await res.json());
Покроковий посібник: Як створити бота в Телеграм: від @BotFather до першого повідомлення
Схожі методи
sendMessageНадсилає текстове повідомлення.forwardMessageПересилає повідомлення.forwardMessagesПересилає кілька повідомлень.copyMessageКопіює повідомлення без посилання на оригінал.copyMessagesКопіює кілька повідомлень.deleteMessageВидаляє повідомлення.deleteMessagesВидаляє кілька повідомлень.sendChatActionНадсилає статус дії в чаті («друкує…» тощо).sendMessageDraftНадсилає чернетку повідомлення — тимчасовий попередній перегляд (Bot API 9.5+).sendContactНадсилає контакт.sendVenueНадсилає місце (venue).setMessageReactionСтавить реакцію на повідомлення.