在Telegram机器人开发中，位置分享是一项非常实用的功能，常用于地图导航、线下服务、设备定位等场景。本文将通过官方Bot API与Python代码，手把手教你实现机器人发送位置信息的功能，从基础原理到实战示例，帮助你快速上手。
准备工作：创建机器人并获取Token
要使用Telegram机器人发送位置信息，首先需要有一个机器人账号。打开Telegram，搜索 @BotFather，发送 /newbot 指令，按提示设置机器人名称和用户名，即可获得一个API Token。Token是机器人调用API的凭证，务必妥善保管。
除了Token，你还需要知道接受位置信息的聊天ID（chat_id）。chat_id可以是用户ID，也可以是群组ID，机器人发送消息时必须指定。
获取聊天ID的几种方式
获取chat_id最简单的方法是利用 getUpdates API。在机器人启动后，向机器人发送任意消息（或在群组中提及机器人），然后访问以下URL：
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates返回的JSON中会包含 message.chat.id，这就是所需的chat_id。也可以使用python-telegram-bot库的 update.message.chat.id 直接获取。
发送位置信息的API：sendLocation
官方Bot API提供了 sendLocation 方法，核心参数如下：
chat_id：必需，接收位置信息的聊天ID。latitude：必需，纬度。longitude：必需，经度。live_period：可选，若设置，表示位置为实时共享，单位为秒，范围60-86400。heading：可选，对于实时位置，方向角度（1-360）。
请求地址为 POST 到 https://api.telegram.org/bot<YOUR_TOKEN>/sendLocation，可以参数形式传递，也可以使用JSON body。
Python示例代码：使用requests库
下面是一段使用Python标准库 requests 发送位置信息的完整示例代码。假设你已获得Token和chat_id：
import requests
TOKEN = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
CHAT_ID = "123456789"
url = f"https://api.telegram.org/bot/sendLocation"
params = {
"chat_id": CHAT_ID,
"latitude": 39.9042,
"longitude": 116.4074,
}
response = requests.post(url, params=params)
print(response.json())运行后，机器人就会向指定聊天发送一个北京坐标的位置卡片。你还可以通过设置 live_period 实现实时位置共享。
使用python-telegram-bot库（可选）
如果使用python-telegram-bot库，代码会更快简洁。安装库后：
from telegram import Bot
bot = Bot(token=TOKEN)
bot.send_location(chat_id=CHAT_ID, latitude=39.9042, longitude=116.4074)该方法同样支持 live_period 等参数，并且异常处理更完善。
常见错误调试与最佳实践
- 错误400：Bad Request chat not found：检查chat_id是否正确，机器人是否被加入该群组或用户是否主动发起会话。
- 错误403：Forbidden：机器人被踢出群组或用户屏蔽了机器人。
- 网络超时：确保网络可以访问Telegram API，必要时设置代理。
另外，建议将Token存储为环境变量，避免硬编码在代码中；同时限制机器人可发送的位置范围，防止滥用。
安全与隐私建议
位置信息属于敏感数据，公开机器人或群组中发送位置时要注意隐私泄露风险。建议只向可信用户发送位置，或使用实时位置时设置合理的过期时间。对于用户主动发送的位置，机器人应严格校验数据，避免存储或转发。
总结
本文从创建机器人到获取chat_id，再到使用sendLocation方法发送位置信息，提供了详细的Python示例代码和调试建议。关键在于理解API参数和正确处理异常。希望这篇指南能帮助你快速集成位置分享功能，打造出更实用、更安全的Telegram机器人。