How Telegram Mini App Geolocation Works: Interactive Maps, Location-Based Games & Privacy Permissions
Discover how Telegram brings real-world coordinates into Mini Apps. Explore location-based games with regional point-of-interest checkpoints, interactive venue maps for events and festivals, and granular opt-in permissions that protect user privacy by default.
Build Pokémon GO-style geo-quests, territorial territory captures, and treasure hunts tied to physical landmarks.
Share pinpoint delivery addresses or hail rides directly within Telegram without downloading separate third-party apps.
Geolocation is strictly disabled by default. You must explicitly approve access per individual Mini App, revocable anytime.
shield_with_heart Privacy-First Architecture: How Telegram Protects Your Location
tune Managing & Revoking Location Permissions Step-by-Step
Granting Permission on First Launch
When you open a geo-enabled Mini App (e.g. an event map or local delivery service), a clear Telegram system dialog will appear: “[App Name] is requesting your location to show nearby places”. Tap Allow While Using App to share your GPS coordinates.
Revoking Location Access Anytime
Want to turn off location for a specific bot? Tap the Three Dots (…) in the top-right corner of the Mini App, tap Settings (or open the Bot's Profile), and toggle off Location Access. The app's coordinate feed is severed immediately.
Automated Status Integration
For Telegram Premium users, Mini Apps can combine location permissions with dynamic emoji status updates—automatically switching your profile status from “At Work 💼” to “At Gym 🏋️” as you move throughout the day.
developer_mode Developer SDK: LocationManager API Pipeline
LocationManager singleton in the Telegram WebApp SDK:
// Initialize Telegram Location Manager
const locManager = window.Telegram.WebApp.LocationManager;
locManager.init(function() {
if (locManager.isInited) {
// Request real-time coordinates
locManager.getLocation(function(data) {
if (data) {
console.log(`Latitude: ${data.latitude}, Longitude: ${data.longitude}`);
console.log(`Accuracy: ${data.horizontal_accuracy} meters`);
// Render user location marker on Leaflet / Mapbox map
renderUserPin(data.latitude, data.longitude);
} else {
console.warn('User declined location permission');
}
});
}
});Simulate GPS coordinate acquisition inside a Telegram Mini App and test how point-of-interest triggers activate.
help Frequently Asked Questions
No. Telegram only provides location updates while the Mini App is actively open on your screen. The moment you close the app or switch to another chat, all location polling is immediately terminated.
Mini Apps communicate directly with the bot developer's server. To protect your data, only use reputable bots from verified organizations. Telegram's terms strictly prohibit selling or misusing sensitive user geolocation data.
