editMessageLiveLocation
Use this method to edit live location messages
Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
business_connection_id | String | Optional | Unique identifier of the business connection on behalf of which the message to be edited was sent |
chat_id | Integer or String | Optional | Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target bot, supergroup or channel in the format @username. |
message_id | Integer | Optional | Required if inline_message_id is not specified. Identifier of the message to edit. |
inline_message_id | String | Optional | Required if chat_id and message_id are not specified. Identifier of the inline message. |
latitude | Float | Yes | Latitude of new location |
longitude | Float | Yes | Longitude of new location |
live_period | Integer | Optional | New period in seconds during which the location can be updated, starting from the message send date. If 0x7FFFFFFF is specified, then the location can be updated forever. Otherwise, the new value must not exceed the current live_period by more than a day, and the live location expiration date must remain within the next 90 days. If not specified, then live_period remains unchanged. |
horizontal_accuracy | Float | Optional | The radius of uncertainty for the location, measured in meters; 0-1500 |
heading | Integer | Optional | Direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. |
proximity_alert_radius | Integer | Optional | The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. |
reply_markup | InlineKeyboardMarkup | Optional | A JSON-serialized object for a new inline keyboard |
Example
PHP — Call editMessageLiveLocation on Botlify Cloud
<?php
// ── Botlify Cloud .env — auto-injected, never hardcode secrets ──
$BOT_TOKEN = getenv('BOT_TOKEN'); // Telegram bot token from @BotFather
$ADMIN_CHAT_ID = getenv('ADMIN_CHAT_ID'); // Your numeric admin Telegram user ID
$BOT_USERNAME = getenv('BOT_USERNAME'); // Bot username without @
$resp = bot('editMessageLiveLocation', [
'latitude' => 37.7749,
'longitude' => -122.4194,
]);
if ($resp['ok'] ?? false) {
$result = $resp['result']; // handle the response
}Botlify Cloud Runtime
Credentials are auto-injected in
Credentials are auto-injected in
.env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.