version: 2.1.3
sendLocation
Use this method to send point on the map. On success, the sent Message is returned.
Parameters
chat_id | int | string | Unique identifier for the target chat or username of the target channel (in the format @channelusername) | Optional |
latitude | float | Latitude of the location | Yes |
longitude | float | Longitude of the location | Yes |
horizontal_accuracy | float | The radius of uncertainty for the location, measured in meters; 0-1500 | Optional |
live_period | int | Period in seconds for which the location will be updated (see Live Locations, should be between 60 and 86400. | Optional |
heading | int | For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. | Optional |
proximity_alert_radius | int | 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 |
disable_notification | bool | Sends the message silently. Users will receive a notification with no sound. | Optional |
protect_content | bool | Protects the contents of the sent message from forwarding and saving | Optional |
reply_to_message_id | int | If the message is a reply, ID of the original message | Optional |
allow_sending_without_reply | bool | Pass True, if the message should be sent even if the specified replied-to message is not found | Optional |
reply_markup | InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply | 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. | Optional |
token | String | You can use this method on another bot with specify this parameter | Optional |
return_array | Boolean | Specify the result type , if pass true results will be array otherwise will be object | Optional |
forgot | Boolean | You can set to not receive request result, dont set it or pass null for turn it off | Optional |
answer | Boolean | You can set to answer to webhook, dont set it or pass null for turn it off | Optional |
Method errors
ErrorName | description |
---|---|
required parameters not found | required parameter for this method is not founded. you can see them in log |
answer mode not allowed | you can use answer mode only once for each webhook update and you already did |
answer mode not allowed bc multi | you can't use answer mode when multi is on |
Method examples
$this->sendLocation(['chat_id' => int | string, 'latitude' => float, 'longitude' => float, 'horizontal_accuracy' => float, 'live_period' => int, 'heading' => int, 'proximity_alert_radius' => int, 'disable_notification' => bool, 'protect_content' => bool, 'reply_to_message_id' => int, 'allow_sending_without_reply' => bool, 'reply_markup' => InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply]);
$this->sendLocation(['latitude' => float, 'longitude' => float]);
Method alices
sendlocation
sendloc
location
loc