sendLocation¶
Returns: Message
- class aiogram.methods.send_location.SendLocation(*, chat_id: int | str, latitude: float, longitude: float, business_connection_id: str | None = None, message_thread_id: int | None = None, horizontal_accuracy: float | None = None, live_period: int | None = None, heading: int | None = None, proximity_alert_radius: int | None = None, disable_notification: bool | None = None, protect_content: bool | ~aiogram.client.default.Default | None = <Default('protect_content')>, allow_paid_broadcast: bool | None = None, message_effect_id: str | None = None, reply_parameters: ~aiogram.types.reply_parameters.ReplyParameters | None = None, reply_markup: ~aiogram.types.inline_keyboard_markup.InlineKeyboardMarkup | ~aiogram.types.reply_keyboard_markup.ReplyKeyboardMarkup | ~aiogram.types.reply_keyboard_remove.ReplyKeyboardRemove | ~aiogram.types.force_reply.ForceReply | None = None, allow_sending_without_reply: bool | None = None, reply_to_message_id: int | None = None, **extra_data: ~typing.Any)[source]¶
Use this method to send point on the map. On success, the sent
aiogram.types.message.Message
is returned.Source: https://core.telegram.org/bots/api#sendlocation
- chat_id: int | str¶
Unique identifier for the target chat or username of the target channel (in the format
@channelusername
)
- latitude: float¶
Latitude of the location
- longitude: float¶
Longitude of the location
- business_connection_id: str | None¶
Unique identifier of the business connection on behalf of which the message will be sent
- message_thread_id: int | None¶
Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
- horizontal_accuracy: float | None¶
The radius of uncertainty for the location, measured in meters; 0-1500
- live_period: int | None¶
Period in seconds during which the location will be updated (see Live Locations, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely.
- heading: int | None¶
For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified.
- proximity_alert_radius: int | None¶
For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.
- model_post_init(context: Any, /) None ¶
We need to both initialize private attributes and call the user-defined model_post_init method.
- disable_notification: bool | None¶
Sends the message silently. Users will receive a notification with no sound.
- protect_content: bool | Default | None¶
Protects the contents of the sent message from forwarding and saving
- allow_paid_broadcast: bool | None¶
Pass
True
to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot’s balance
- message_effect_id: str | None¶
Unique identifier of the message effect to be added to the message; for private chats only
- reply_parameters: ReplyParameters | None¶
Description of the message to reply to
- reply_markup: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | None¶
Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user
- allow_sending_without_reply: bool | None¶
Pass
True
if the message should be sent even if the specified replied-to message is not foundDeprecated since version API:7.0: https://core.telegram.org/bots/api-changelog#december-29-2023
- reply_to_message_id: int | None¶
If the message is a reply, ID of the original message
Deprecated since version API:7.0: https://core.telegram.org/bots/api-changelog#december-29-2023
Usage¶
As bot method¶
result: Message = await bot.send_location(...)
Method as object¶
Imports:
from aiogram.methods.send_location import SendLocation
alias:
from aiogram.methods import SendLocation
With specific bot¶
result: Message = await bot(SendLocation(...))
As reply into Webhook in handler¶
return SendLocation(...)
As shortcut from received object¶
aiogram.types.chat_join_request.ChatJoinRequest.answer_location()
aiogram.types.chat_join_request.ChatJoinRequest.answer_location_pm()
aiogram.types.chat_member_updated.ChatMemberUpdated.answer_location()
aiogram.types.inaccessible_message.InaccessibleMessage.answer_location()
aiogram.types.inaccessible_message.InaccessibleMessage.reply_location()