Location

class telegram.Location(longitude, latitude, horizontal_accuracy=None, live_period=None, heading=None, proximity_alert_radius=None, *, api_kwargs=None)

Bases: telegram.TelegramObject

This object represents a point on the map.

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

Use In

• telegram.Bot.edit_message_live_location()

• telegram.Bot.send_location()

Available In

• telegram.BusinessLocation.location

• telegram.ChatLocation.location

• telegram.ChosenInlineResult.location

• telegram.ExternalReplyInfo.location

• telegram.InlineQuery.location

• telegram.Message.effective_attachment

• telegram.Message.location

• telegram.Venue.location

Parameters:

• longitude (float) – Longitude as defined by the sender.

• latitude (float) – Latitude as defined by the sender.

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

• live_period (int | datetime.timedelta, optional) –

  Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

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

• heading (int, optional) – The direction in which user is moving, in degrees; 1-360. For active live locations only.

• proximity_alert_radius (int, optional) – Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

longitude

Longitude as defined by the sender.

Type:

float

latitude

Latitude as defined by the sender.

Type:

float

horizontal_accuracy

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

Type:

float

live_period

Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

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. The direction in which user is moving, in degrees; 1-360. For active live locations only.

Type:

int

proximity_alert_radius

Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

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.

MIN_HEADING = 1

telegram.constants.LocationLimit.MIN_HEADING

Added in version 20.0.