react-native-turbo-mock-location-detector
TypeScript icon, indicating that this package has built-in type declarations

2.3.1 • Public • Published

react-native-turbo-mock-location-detector

Protect your business from location spoofing. Mock location detector is designed to detect and prevent any attempts to spoof GPS location, making it the perfect solution for any use case that requires accurate location tracking. Common examples include fleet management and logistics apps where truck drivers may use tools like Location Changer and Mock Locations.

Library supports both new and old architecture of React Native.

Installation

yarn add react-native-turbo-mock-location-detector
cd ios && pod install

Expo

Works with no additional config

Prerequisites

  1. Use eg. react-native-permissions to ask for location permission
  2. In your AndroidManifest.xml use at least one of:
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  1. In your Info.plist use:
<key>NSLocationWhenInUseUsageDescription</key>
<string>YOUR TEXT</string>

Usage

import { isMockingLocation, MockLocationDetectorErrorCode, MockLocationDetectorError } from 'react-native-mock-location-detector'

useEffect(() => {
    isMockingLocation()
        .then(({ isLocationMocked }) => {
            // isLocationMocked: boolean
            // boolean result for Android and iOS >= 15.0
        })
        .catch((error: MockLocationDetectorError) => {
            // error.message - descriptive message
            switch (error.code) {
                case MockLocationDetectorErrorCode.GPSNotEnabled: {
                    // user disabled GPS
                    return
                }
                case MockLocationDetectorErrorCode.NoLocationPermissionEnabled: {
                    // user has no permission to access location
                    return
                }
                case MockLocationDetectorErrorCode.CantDetermine: {
                    // always for iOS < 15.0
                    // for android and iOS if couldn't fetch GPS position
                }
            }
        })
}, [])

Support

Lib version RN version
1.0 - 1.2 >= 0.68
^2.0 0.71, 0.72

Testing

Library was tested:

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT


Package Sidebar

Install

npm i react-native-turbo-mock-location-detector

Weekly Downloads

2,642

Version

2.3.1

License

MIT

Unpacked Size

84.3 kB

Total Files

36

Last publish

Collaborators

  • jpudysz