sendLocation
متداز این متد برای ارسال نقطه‌ای روی نقشه استفاده کنید. در صورت موفقیت، Message ارسال‌شده برگردانده می‌شود.
خروجی: Message
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| business_connection_id | String | اختیاری | شناسهٔ یکتای اتصال کسب‌وکاری که پیام از طرف آن فرستاده می‌شود. |
| chat_id | Integer or String | الزامی | شناسهٔ یکتای گفتگوی هدف یا نام‌کاربری ربات، ابرگروه یا کانال هدف با قالب @username |
| message_thread_id | Integer | اختیاری | شناسهٔ یکتای رشتهٔ پیام (تاپیک) فروم هدف؛ فقط برای ابرگروه‌های فروم و گفتگوهای خصوصی ربات‌هایی که حالت تاپیک فروم برایشان فعال است. |
| direct_messages_topic_id | Integer | اختیاری | شناسهٔ تاپیک پیام مستقیم که پیام به آن فرستاده می‌شود؛ اگر پیام به یک گفتگوی پیام مستقیم فرستاده شود الزامی است. |
| ephemeral_message_parameters | EphemeralMessageParameters | اختیاری | شیء سریالایز‌شده به JSON شامل پارامترهای پیام موقت (ephemeral) که باید فرستاده شود. |
| latitude | Float | الزامی | عرض جغرافیایی موقعیت |
| longitude | Float | الزامی | طول جغرافیایی موقعیت |
| horizontal_accuracy | Float | اختیاری | شعاع عدم‌قطعیت موقعیت بر حسب متر؛ ۰ تا ۱۵۰۰ |
| live_period | Integer | اختیاری | مدت زمانی (ثانیه) که موقعیت به‌روزرسانی می‌شود (موقعیت‌های زنده را ببینید)؛ باید بین ۶۰ تا ۸۶۴۰۰ باشد، یا 0x7FFFFFFF برای موقعیت‌های زنده‌ای که بی‌نهایت قابل ویرایش‌اند. برای پیام‌های موقت باید ۰ باشد. |
| heading | Integer | اختیاری | برای موقعیت‌های زنده، جهتی که کاربر در آن حرکت می‌کند، بر حسب درجه. در صورت مشخص‌شدن باید بین ۱ تا ۳۶۰ باشد. |
| proximity_alert_radius | Integer | اختیاری | برای موقعیت‌های زنده، بیشترین فاصله برای هشدار مجاورت نزدیک‌شدن به عضو دیگر گفتگو، بر حسب متر. در صورت مشخص‌شدن باید بین ۱ تا ۱۰۰۰۰۰ باشد. |
| disable_notification | Boolean | اختیاری | پیام را بی‌صدا می‌فرستد. کاربران اعلانی بدون صدا دریافت می‌کنند. |
| protect_content | Boolean | اختیاری | محتوای پیام ارسالی را از فوروارد و ذخیره‌شدن محافظت می‌کند. |
| allow_paid_broadcast | Boolean | اختیاری | برای مجاز شدن ارسال تا ۱۰۰۰ پیام در ثانیه و نادیده‌گرفتن محدودیت‌های ارسال انبوه، با هزینهٔ ۰٫۱ ستارهٔ تلگرام برای هر پیام، True بدهید. ستارهٔ مربوط از موجودی ربات کسر می‌شود. |
| message_effect_id | String | اختیاری | شناسهٔ یکتای افکتی که به پیام اضافه می‌شود؛ فقط برای گفتگوهای خصوصی |
| suggested_post_parameters | SuggestedPostParameters | اختیاری | شیء سریالایز‌شده به JSON شامل پارامترهای پست پیشنهادی که باید فرستاده شود؛ فقط برای گفتگوهای پیام مستقیم. اگر پیام در پاسخ به یک پست پیشنهادی دیگر فرستاده شود، آن پست پیشنهادی به‌طور خودکار رد می‌شود. |
| reply_parameters | ReplyParameters | اختیاری | توضیحات پیامی که به آن پاسخ داده می‌شود. |
| reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | اختیاری | گزینه‌های اضافی رابط. شیء سریالایز‌شده به JSON برای کیبورد اینلاین، کیبورد پاسخ سفارشی، دستور حذف کیبورد پاسخ یا اجبار به پاسخ از طرف کاربر. |