Skip to content
Back to top
View this page

# InlineQueryResultLocation

class telegram.InlineQueryResultLocation(id, latitude, longitude, title, live_period=None, reply_markup=None, input_message_content=None, horizontal_accuracy=None, heading=None, proximity_alert_radius=None, thumbnail_url=None, thumbnail_width=None, thumbnail_height=None, *, api_kwargs=None)

  Bases: `telegram.InlineQueryResult`

  Represents a location on a map. By default, the location will be sent by the user. Alternatively, you can use `input_message_content` to send a message with the specified content instead of the location.

  Use In

  - `telegram.Bot.answer_guest_query()`

  - `telegram.Bot.answer_inline_query()`

  - `telegram.Bot.answer_web_app_query()`

  - `telegram.Bot.save_prepared_inline_message()`

  Changed in version 20.5: Removed the deprecated arguments and attributes `thumb_*`.

  Parameters:

    - id (`str`) – Unique identifier for this result, `1`- `64` Bytes.

    - latitude (`float`) – Location latitude in degrees.

    - longitude (`float`) – Location longitude in degrees.

    - title (`str`) – Location title.

    - horizontal_accuracy (`float`, optional) – The radius of uncertainty for the location, measured in meters; 0- `1500`.

    - live_period (`int` | `datetime.timedelta`, optional) –

      Period in seconds for which the location will be updated, should be between `60` and `86400`.

      Changed in version v22.2: `datetime.timedelta` objects are accepted in addition to plain `int` values.

    - heading (`int`, optional) – 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`, optional) – For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between `1` and `100000` if specified.

    - reply_markup (`telegram.InlineKeyboardMarkup`, optional) – Inline keyboard attached to the message.

    - input_message_content (`telegram.InputMessageContent`, optional) – Content of the message to be sent instead of the location.

    - thumbnail_url (`str`, optional) –

      Url of the thumbnail for the result.

      Added in version 20.2.

    - thumbnail_width (`int`, optional) –

      Thumbnail width.

      Added in version 20.2.

    - thumbnail_height (`int`, optional) –

      Thumbnail height.

      Added in version 20.2.

  type

    `'location'`.

    Type:

      `str`

  id

    Unique identifier for this result, `1`- `64` Bytes.

    Type:

      `str`

  latitude

    Location latitude in degrees.

    Type:

      `float`

  longitude

    Location longitude in degrees.

    Type:

      `float`

  title

    Location title.

    Type:

      `str`

  horizontal_accuracy

    Optional. The radius of uncertainty for the location, measured in meters; 0- `1500`.

    Type:

      `float`

  live_period

    Optional. Period in seconds for which the location will be updated, should be between `60` and `86400` or `2147483647` for live locations that can be edited indefinitely.

    Deprecated since version v22.2: In a future major version this attribute will be of type `datetime.timedelta`. You can opt-in early by setting PTB_TIMEDELTA=true or `PTB_TIMEDELTA=1` as an environment variable.

    Type:

      `int` | `datetime.timedelta`

  heading

    Optional. For live locations, a direction in which the user is moving, in degrees. Must be between `1` and `360` if specified.

    Type:

      `int`

  proximity_alert_radius

    Optional. For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between `1` and `100000` if specified.

    Type:

      `int`

  reply_markup

    Optional. Inline keyboard attached to the message.

    Type:

      `telegram.InlineKeyboardMarkup`

  input_message_content

    Optional. Content of the message to be sent instead of the location.

    Type:

      `telegram.InputMessageContent`

  thumbnail_url

    Optional. Url of the thumbnail for the result.

    Added in version 20.2.

    Type:

      `str`

  thumbnail_width

    Optional. Thumbnail width.

    Added in version 20.2.

    Type:

      `int`

  thumbnail_height

    Optional. Thumbnail height.

    Added in version 20.2.

    Type:

      `int`

  HORIZONTAL_ACCURACY = 1500

    `telegram.constants.LocationLimit.HORIZONTAL_ACCURACY`

    Added in version 20.0.

  MAX_HEADING = 360

    `telegram.constants.LocationLimit.MAX_HEADING`

    Added in version 20.0.

  MAX_LIVE_PERIOD = 86400

    `telegram.constants.LocationLimit.MAX_LIVE_PERIOD`

    Added in version 20.0.

  MAX_PROXIMITY_ALERT_RADIUS = 100000

    `telegram.constants.LocationLimit.MAX_PROXIMITY_ALERT_RADIUS`

    Added in version 20.0.

  MIN_HEADING = 1

    `telegram.constants.LocationLimit.MIN_HEADING`

    Added in version 20.0.

  MIN_LIVE_PERIOD = 60

    `telegram.constants.LocationLimit.MIN_LIVE_PERIOD`

    Added in version 20.0.

  MIN_PROXIMITY_ALERT_RADIUS = 1

    `telegram.constants.LocationLimit.MIN_PROXIMITY_ALERT_RADIUS`

    Added in version 20.0.