InputLocationMessageContent

class telegram.InputLocationMessageContent(latitude, longitude, live_period=None, horizontal_accuracy=None, heading=None, proximity_alert_radius=None, *, api_kwargs=None)[source]
See More

Bases: telegram.InputMessageContent

Represents the content of a location message to be sent as the result of an inline query.

Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their latitude and longitude are equal.

Available In

Parameters:

  • latitude (float) – Latitude of the location in degrees.

  • longitude (float) – Longitude of the location in degrees.

  • 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 or 2147483647 for live locations that can be edited indefinitely.

    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.

latitude[source]

Latitude of the location in degrees.

Type:

float

longitude[source]

Longitude of the location in degrees.

Type:

float

horizontal_accuracy[source]

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

Type:

float

live_period[source]

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

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[source]

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[source]

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

HORIZONTAL_ACCURACY = 1500[source]

telegram.constants.LocationLimit.HORIZONTAL_ACCURACY

Added in version 20.0.

MAX_HEADING = 360[source]

telegram.constants.LocationLimit.MAX_HEADING

Added in version 20.0.

MAX_LIVE_PERIOD = 86400[source]

telegram.constants.LocationLimit.MAX_LIVE_PERIOD

Added in version 20.0.

MAX_PROXIMITY_ALERT_RADIUS = 100000[source]

telegram.constants.LocationLimit.MAX_PROXIMITY_ALERT_RADIUS

Added in version 20.0.

MIN_HEADING = 1[source]

telegram.constants.LocationLimit.MIN_HEADING

Added in version 20.0.

MIN_LIVE_PERIOD = 60[source]

telegram.constants.LocationLimit.MIN_LIVE_PERIOD

Added in version 20.0.

MIN_PROXIMITY_ALERT_RADIUS = 1[source]

telegram.constants.LocationLimit.MIN_PROXIMITY_ALERT_RADIUS

Added in version 20.0.