Описание
Представляет местоположение на карте. По умолчанию местоположение будет отправлено пользователем. В качестве альтернативы можно использовать input_message_content для отправки сообщения с указанным содержимым вместо местоположения.
| Поле | Тип | Описание |
|---|---|---|
| type | String | Тип результата, должен быть location |
| id | String | Уникальный идентификатор этого результата, 1-64 байта |
| latitude | Float | Широта местоположения в градусах |
| longitude | Float | Долгота местоположения в градусах |
| title | String | Название местоположения |
| horizontal_accuracy | Float | Необязательно. Радиус неопределённости местоположения, измеряется в метрах; 0-1500 |
| live_period | Integer | Необязательно. Период в секундах, в течение которого местоположение может обновляться, должен быть между 60 и 86400, или 0x7FFFFFFF для живых местоположений, которые можно редактировать бесконечно. |
| heading | Integer | Необязательно. Для живых местоположений — направление движения пользователя в градусах. Должно быть между 1 и 360, если указано. |
| proximity_alert_radius | Integer | Необязательно. Для живых местоположений — максимальное расстояние для оповещений о приближении к другому участнику чата, в метрах. Должно быть между 1 и 100000, если указано. |
| reply_markup | InlineKeyboardMarkup | Необязательно. Встроенная клавиатура, прикреплённая к сообщению |
| input_message_content | InputMessageContent | Необязательно. Содержимое сообщения, которое будет отправлено вместо местоположения |
| thumbnail_url | String | Необязательно. URL миниатюры для результата |
| thumbnail_width | Integer | Необязательно. Ширина миниатюры |
| thumbnail_height | Integer | Необязательно. Высота миниатюры |
Примеры
json
{
"type": "location",
"id": "unique_location_123",
"latitude": 40.7128,
"longitude": -74.0060,
"title": "New York City",
"horizontal_accuracy": 50.5,
"live_period": 3600,
"heading": 90,
"proximity_alert_radius": 100,
"reply_markup": {
"inline_keyboard": [
[
{
"text": "View Details",
"callback_data": "location_details_nyc"
}
]
]
},
"input_message_content": {
"message_text": "📍 This is New York City!\nLatitude: 40.7128\nLongitude: -74.0060",
"parse_mode": "Markdown"
},
"thumbnail_url": "https://example.com/thumbnails/nyc.jpg",
"thumbnail_width": 100,
"thumbnail_height": 100
}История изменений
- API 5.0. Обновлен объект InlineQueryResultLocation: Добавлены поля heading, proximity_alert_radius, horizontal_accuracy
- API 6.6. Обновлен объект InlineQueryResultLocation: Переименованы поля thumb_url, thumb_width, thumb_height в thumbnail_url, thumbnail_width, thumbnail_height
Дополнительно
- InlineKeyboardMarkup - Объект для создания встроенной клавиатуры, которая отображается непосредственно в сообщении.
- InputMessageContent - Объект, представляющий содержимое сообщения для отправки через инлайн-запрос, поддерживающий пять различных типов контента.