为什么需要获取用户地理位置？
在Telegram机器人开发中，地理位置信息可以带来丰富的场景应用，例如：附近商户推荐、配送服务、拼车、社交匹配、天气查询等。通过精准获取用户位置，机器人可以提供更具个性化的服务。本文将手把手教你如何在Telegram机器人中获取用户地理位置，并提供可直接运行的代码示例。
Telegram位置消息基础
Telegram中与位置相关的消息类型主要有两种：
- Location：包含经纬度（latitude和longitude），可选水平和垂直精度。
- Venue：包含地点名称、地址等信息，本质上也是位置消息的扩展。
机器人可以通过以下两种方式获取用户地理位置：
- 被动接收：用户直接向机器人发送位置消息（通过Telegram客户端中的“附件-位置”），机器人通过Update获得位置。
- 主动请求：机器人发送一个带有“请求位置”按钮的键盘，用户点击后自动向机器人分享位置。
下面分别详细介绍。
方式一：被动接收用户位置
这是最简单的方式，无需额外配置。用户只需在聊天窗口点击“附加”（回形针图标），选择“位置”，然后发送即可。机器人端接收到的Update对象中，message.location字段包含位置信息。
代码示例（Python）
使用python-telegram-bot库示例：
from telegram.ext import Application, MessageHandler, filters
async def location_handler(update, context):
user = update.effective_user
loc = update.message.location
latitude = loc.latitude
longitude = loc.longitude
await update.message.reply_text(
f"感谢 {user.first_name} 分享位置！\n"
f"纬度: \n经度: "
)
def main():
app = Application.builder().token("YOUR_BOT_TOKEN").build()
app.add_handler(MessageHandler(filters.LOCATION, location_handler))
app.run_polling()上述代码中，filters.LOCATION会匹配所有位置消息。请注意，用户发送位置时，Telegram客户端会自动将位置作为消息发送，机器人无需任何特殊授权。
方式二：主动请求用户位置
在实际场景中，被动接收方式往往不够主动。如果希望在特定流程中强制要求用户提供位置，可以使用Telegram提供的ReplyKeyboardMarkup，在键盘按钮上设置request_location=True，这样当用户点击该按钮时，Telegram客户端会弹出位置选择界面，用户确认后位置自动发送给机器人。
创建请求位置键盘
from telegram import ReplyKeyboardMarkup
def location_keyboard():
keyboard = [
[{"text": "📍 分享位置", "request_location": True}],
["❌ 取消"]
]
return ReplyKeyboardMarkup(keyboard, resize_keyboard=True, one_time_keyboard=True)这里request_location必须为True，按钮文本可自定义。当用户点击该按钮时，客户端会请求位置权限，并将位置作为消息发送给机器人。
发送键盘并处理回复
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
await update.message.reply_text(
"请点击下方按钮，分享您的位置：",
reply_markup=location_keyboard()
)
async def location_handler(update: Update, context: ContextTypes.DEFAULT_TYPE):
location = update.message.location
if location:
lat = location.latitude
lon = location.longitude
await update.message.reply_text(f"获取成功！您的位置：(, )")
else:
# 用户点了取消或其他操作
await update.message.reply_text("您取消了位置分享。")
def main():
app = Application.builder().token("YOUR_BOT_TOKEN").build()
app.add_handler(CommandHandler("start", start))
app.add_handler(MessageHandler(filters.LOCATION, location_handler))
app.add_handler(MessageHandler(filters.COMMAND, location_handler))
app.run_polling()注意：如果用户点击了“取消”按钮，机器人会收到一条普通文本消息，而不是位置消息，因此需要处理非位置消息。上述代码简单处理了所有非命令消息。
解析位置更新数据
当机器人收到update.message.location时，该字段是一个Location对象，主要属性如下：
latitude：纬度，浮点数，区间[-90, 90]。longitude：经度，浮点数，区间[-180, 180]。horizontal_accuracy：水平精度，单位米，可选。live_period：实时位置有效时间（秒），可选。如果是实时位置共享，会带此字段。heading：方向，基于北的度数，可选。proximity_alert_radius：接近提醒半径，可选。
解析代码如下：
from telegram import Location
def parse_location(location: Location):
data = {
"latitude": location.latitude,
"longitude": location.longitude,
"horizontal_accuracy": location.horizontal_accuracy,
"live_period": location.live_period,
"heading": location.heading
}
return data对于Venue类型的消息，update.message.venue包含location、title和address，提取方式类似。
进阶：请求实时位置
除了单次位置分享，Telegram还支持实时位置共享。用户可以通过聊天界面中的“位置”菜单选择“共享实时位置”，设置时长。机器人同样可以收到实时位置更新。要主动请求实时位置，目前官方API没有直接的方法，只能由用户在客户端发起。但机器人可以处理message.location.live_period字段来识别实时位置消息。
如果机器人需要持续获取用户位置，可以提示用户开启实时共享，并在收到消息时检查live_period是否大于0。
注意事项与隐私安全
获取用户地理位置是敏感操作，开发者必须遵守以下原则：
- 明确告知用途：在交互前向用户说明为什么要获取位置、用于什么服务。
- 最小化收集：只在必要场景中请求位置，不要频繁索要。
- 数据加密存储：如果存储用户位置，必须加密，且遵循相关隐私法规（如GDPR）。
- 允许撤回授权：用户可以在Telegram中取消位置权限（设置-隐私和设置-数据设置），机器人要做好应对。
- 不要滥用实时位置：实时位置可能涉及人身安全，务必谨慎使用。
常见问题（FAQ）
1. 为什么点击请求位置按钮后没有反应？
请确保按钮的request_location设置为True，并且使用ReplyKeyboardMarkup发送。另外，某些Telegram客户端版本可能要求用户开启位置权限，请检查系统设置。
2. 用户拒绝分享位置时，机器人如何感知？
Telegram没有直接的“拒绝”回调。当用户点击其他按钮或输入文字时，机器人收到的不是位置消息，因此可以通过判断消息类型来处理。建议在键盘中设置“取消”按钮，用户点击后发送文本消息，机器人据此感知拒绝行为。
3. 能否获取用户精确到街道的地址？
Telegram提供的是经纬度，如需转换为街道地址，可使用地理编码API（如Google Maps、Mapbox、高德地图等）进行反向地理编码。
4. 位置消息的有效期是多久？
普通位置消息立即生效；实时位置消息在live_period秒内有效，到期后自动停止更新。
总结
通过本文的学习，你已经掌握了Telegram机器人获取用户地理位置的两种核心方式：被动接收和主动请求。结合实际的代码示例，你可以快速搭建一个位置感知机器人。记住，地理位置是敏感信息，一定要在合理合规的前提下使用。更多机器人开发技巧，请继续关注Telegram官网中文版的教程板块。