Skip to main content
Back to plugins
@capgo/capacitor-mock-location-detector
Tutorial
@capgo/capacitor-mock-location-detector

Mock Location Detector

Detect simulated GPS locations and developer tooling that enables spoofing apps

Guide

Tutorial on Mock Location Detector

Using @capgo/capacitor-mock-location-detector

Detect simulated GPS locations using layered, App Store-safe checks on iOS and Android.

Install

bun add @capgo/capacitor-mock-location-detector
bunx cap sync

What This Plugin Exposes

  • analyze - Run all available checks and return a scored composite result.
  • runCheck - Execute one named detection layer.
  • getCapabilities - Discover supported checks on the current platform.
  • startMonitoring / stopMonitoring - Periodic analysis with events.
  • openDeveloperSettings - Guide users to disable developer or mock tooling.

Example Usage

import { MockLocationDetector } from '@capgo/capacitor-mock-location-detector';

const result = await MockLocationDetector.analyze({
  requestLocationSample: true,
  minDetectedChecks: 1,
});

if (result.isSimulated) {
  console.warn('Possible GPS spoofing detected', result.checks);
}

await MockLocationDetector.openDeveloperSettings();

Full Reference