Method: contacts.getLocated

Back to methods index

Get contacts near you


Name Type Description Required
background Bool While the geolocation of the current user is public, clients should update it in the background every half-an-hour or so, while setting this flag.
Do this only if the new location is more than 1 KM away from the previous one, or if the previous location is unknown.
geo_point InputGeoPoint Geolocation Optional
self_expires int If set, the geolocation of the current user will be public for the specified number of seconds; pass 0x7fffffff to disable expiry, 0 to make the current geolocation private; if the flag isn’t set, no changes will be applied. Optional

Return type: Updates

Can bots use this method: NO

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('', 'madeline.php');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$Updates = $MadelineProto->contacts->getLocated(['background' => Bool, 'geo_point' => InputGeoPoint, 'self_expires' => int, ]);

Or, if you’re into Lua:

Updates = contacts.getLocated({background=Bool, geo_point=InputGeoPoint, self_expires=int, })


Code Type Description
400 GEO_POINT_INVALID Invalid geoposition provided
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.