send_location#

template<class Agent>
api_result<message_t, Agent&&> send_location(Agent &&agent, send_location_args_t args)#

agent is any object satisfying agent concept.

Use this method to send point on the map. On success, the sent Message is returned.

struct send_location_args_t#

Arguments that should be passed to send_location().

variant_t<integer_t, string_t> chat_id#

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

float_t latitude#

Latitude of the location

float_t longitude#

Longitude of the location

optional_t<float_t> horizontal_accuracy#

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

optional_t<integer_t> live_period#

Period in seconds for which the location will be updated (see Live Locations, should be between 60 and 86400.

optional_t<integer_t> heading#

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

optional_t<integer_t> proximity_alert_radius#

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

optional_t<boolean_t> disable_notification#

Sends the message silently. Users will receive a notification with no sound.

optional_t<integer_t> reply_to_message_id#

If the message is a reply, ID of the original message

optional_t<boolean_t> allow_sending_without_reply#

Pass True, if the message should be sent even if the specified replied-to message is not found

optional_t<variant_t<inline_keyboard_markup_t, reply_keyboard_markup_t, reply_keyboard_remove_t, force_reply_t>> reply_markup#

Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.