ജിയോഫെൻസിംഗ് API

Tracelet ഒരു കരുത്തുറ്റ, ഓഫ്‌ലൈൻ-ആദ്യ ജിയോഫെൻസിംഗ് എഞ്ചിൻ നൽകുന്നു. സ്റ്റാൻഡേർഡ് ഒഎസ് ജിയോഫെൻസിംഗിൽ നിന്ന് വ്യത്യസ്തമായി 20-100 ജിയോഫെൻസുകളിൽ പരിമിതപ്പെടുത്തിയിരിക്കുന്നു, കൂടാതെ നിങ്ങളുടെ ആപ്പ് ഉണർത്താൻ OS ആവശ്യപ്പെടുന്നു, ട്രേസ്ലെറ്റ് റസ്റ്റ് എഞ്ചിനിനുള്ളിൽ ജിയോഫെൻസുകളെ ആന്തരികമായി വിലയിരുത്തുന്നു. ഇത് പൂജ്യം അധിക ബാറ്ററി ചോർച്ചയോടുകൂടിയ അൺലിമിറ്റഡ് ജിയോഫെൻസുകൾ പ്രവർത്തനക്ഷമമാക്കുന്നു.

1. സർക്കുലർ vs പോളിഗോൺ ജിയോഫെൻസസ്

സാധാരണ വൃത്താകൃതിയിലുള്ള ജിയോഫെൻസുകളേയും സങ്കീർണ്ണമായ ബഹുഭുജ ജിയോഫെൻസുകളേയും ട്രേസ്ലെറ്റ് പിന്തുണയ്ക്കുന്നു.

വൃത്താകൃതിയിലുള്ള ജിയോഫെൻസുകൾ

ഒരു വൃത്താകൃതിയിലുള്ള ജിയോഫെൻസ് ഒരു കേന്ദ്ര കോർഡിനേറ്റും ആരവും (മീറ്ററിൽ) നിർവചിച്ചിരിക്കുന്നു.

final circular = tl.Geofence(
  identifier: 'headquarters',
  latitude: 37.7749,
  longitude: -122.4194,
  radius: 200, // 200 meters
  notifyOnEntry: true,
  notifyOnExit: true,
  notifyOnDwell: true, // Triggers if they stay inside
  loiteringDelay: 300, // Trigger dwell after 5 minutes
);

പോളിഗോൺ ജിയോഫെൻസുകൾ

ഒരു ബഹുഭുജ ജിയോഫെൻസ് നിർവചിക്കുന്നത് സങ്കീർണ്ണമായ ആകൃതിയുടെ (പാർക്ക് അല്ലെങ്കിൽ കെട്ടിടം പോലെ) രൂപരേഖ നൽകുന്ന കോർഡിനേറ്റുകളുടെ ഒരു നിരയാണ്.

final polygon = tl.Geofence.polygon(
  identifier: 'golden_gate_park',
  vertices: [
    tl.Coordinate(latitude: 37.773972, longitude: -122.431297),
    tl.Coordinate(latitude: 37.769996, longitude: -122.511055),
    tl.Coordinate(latitude: 37.764516, longitude: -122.508566),
  ],
  notifyOnEntry: true,
  notifyOnExit: true,
);

2. ജിയോഫെൻസുകൾ ചേർക്കുന്നതും നീക്കംചെയ്യുന്നതും

പ്രാദേശിക SQLite ഡാറ്റാബേസിൽ എല്ലാ ജിയോഫെൻസുകളും Tracelet സംഭരിക്കുന്നു. ആപ്പ് പുനരാരംഭിക്കുന്നതിലുടനീളം അവ സ്ഥിരത പുലർത്തുന്നു എന്നാണ് ഇതിനർത്ഥം. ആപ്പ് സമാരംഭിക്കുമ്പോഴെല്ലാം നിങ്ങൾ അവ വീണ്ടും ചേർക്കേണ്ടതില്ല.

ജിയോഫെൻസുകൾ ചേർക്കുന്നു

നിങ്ങൾക്ക് ഒരൊറ്റ ജിയോഫെൻസുകളോ ജിയോഫെൻസുകളുടെ ഒരു നിരയോ ചേർക്കാം.

// Add a single geofence
await tl.Tracelet.addGeofence(circular);
 
// Add multiple geofences efficiently
await tl.Tracelet.addGeofences([circular, polygon]);

ജിയോഫെൻസുകൾ നീക്കംചെയ്യുന്നു

അവരുടെ അദ്വിതീയ ഐഡൻ്റിഫയർ ഉപയോഗിച്ച് അവയെ നീക്കം ചെയ്യുക അല്ലെങ്കിൽ മുഴുവൻ ഡാറ്റാബേസും മായ്‌ക്കുക.

// Remove a specific geofence
await tl.Tracelet.removeGeofence('headquarters');
 
// Remove all geofences entirely
await tl.Tracelet.removeGeofences();

3. സജീവ ജിയോഫെൻസുകളുടെ ലിസ്റ്റിംഗ്

ഏത് ജിയോഫെൻസുകളാണ് നിലവിൽ നിരീക്ഷിക്കപ്പെടുന്നതെന്ന് കാണാൻ നിങ്ങൾക്ക് എപ്പോൾ വേണമെങ്കിലും SQLite ഡാറ്റാബേസിൽ അന്വേഷിക്കാവുന്നതാണ്.

final geofences = await tl.Tracelet.getGeofences();
for (final fence in geofences) {
  print('Monitoring: \${fence.identifier}');
}

4. ജിയോഫെൻസ് ഇവൻ്റുകൾക്കായി കേൾക്കുന്നു

ഉപയോക്താവ് ജിയോഫെൻസ് അതിർത്തി കടക്കുമ്പോൾ, ട്രെയ്‌സ്‌ലെറ്റ് onGeofence ഇവൻ്റ് വെടിവയ്ക്കുന്നു. ലൊക്കേഷൻ അപ്‌ഡേറ്റ് സമയത്ത് റസ്റ്റ് കോറിൽ മൂല്യനിർണ്ണയം നടക്കുന്നതിനാൽ, ആപ്പ് കൊല്ലപ്പെട്ടാലും ഈ ഇവൻ്റുകൾ പ്രവർത്തിക്കും (നിങ്ങളുടെ തലയില്ലാത്ത കോൾബാക്ക് ട്രിഗർ ചെയ്യുന്നു).

tl.Tracelet.onGeofence((evt) {
  if (evt.action == tl.GeofenceEventAction.ENTER) {
    print('User entered: \${evt.identifier}');
  } else if (evt.action == tl.GeofenceEventAction.EXIT) {
    print('User exited: \${evt.identifier}');
  } else if (evt.action == tl.GeofenceEventAction.DWELL) {
    print('User is dwelling inside: \${evt.identifier}');
  }
});

5. Android: ഫോർഗ്രൗണ്ട് സേവനവും Google Play നയവും

Tracelet-ൻ്റെ സ്റ്റാൻഡേർഡ് ജിയോഫെൻസ് മോഡ് നേറ്റീവ് Android Geofence API ഉപയോഗിക്കുന്നു (GeofencingClient), ഇത് എൻ്റർ/എക്സിറ്റ് - നിങ്ങളുടെ ആപ്ലിക്കേഷനിലേക്ക് വീണ്ടും സമാരംഭിക്കുന്നു ഹെഡ്‌ലെസ് ടാസ്‌ക് - ആപ്പ് താൽക്കാലികമായി നിർത്തുകയോ അവസാനിപ്പിക്കുകയോ ചെയ്യുമ്പോൾ, ഇല്ലാതെ a മുൻവശത്തെ സേവനം. സ്റ്റാൻഡേർഡ് മോഡിൽ startGeofences() എന്ന് വിളിക്കുന്നത് അല്ല ആരംഭിക്കുന്നില്ല ഒരു ഫോർഗ്രൗണ്ട് സേവനം (3.5.x പോലെ), അതിനാൽ ഇത് ഡിഫോൾട്ടായി അനുസരിച്ചാണ്.

ജിയോഫെൻസിംഗിനായി മാത്രം നിങ്ങൾ Tracelet ഉപയോഗിക്കുകയാണെങ്കിൽ

1. അരുത് ഫോർഗ്രൗണ്ട് സേവനം പ്രവർത്തനക്ഷമമാക്കുക:

   await tl.Tracelet.ready(const tl.Config(
     android: tl.AndroidConfig(
       foregroundService: tl.ForegroundServiceConfig(enabled: false),
     ),
     geofence: tl.GeofenceConfig(geofenceModeHighAccuracy: false),
   ));
   await tl.Tracelet.startGeofences();

2. ട്രാക്ക്ലെറ്റ് SDK FOREGROUND_SERVICE / FOREGROUND_SERVICE_LOCATION പ്രഖ്യാപിക്കുന്നു അതിൻ്റെ തുടർച്ചയായ ട്രാക്കിംഗ് ഉപയോഗത്തിന്. നിങ്ങളുടെ ആപ്പ് ഒരിക്കലും തുടർച്ചയായി ചെയ്യുന്നില്ലെങ്കിൽ ട്രാക്കിംഗ്, മാനിഫെസ്റ്റ്-ലയനവുമായി ലയിപ്പിച്ച മാനിഫെസ്റ്റിൽ നിന്ന് അവരെ നീക്കം ചെയ്യുക നിങ്ങളുടെ ആപ്പിൻ്റെ android/app/src/main/AndroidManifest.xml-ലെ remove നിയമം:

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
             xmlns:tools="http://schemas.android.com/tools">
       <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION"
           tools:node="remove" />
       <uses-permission android:name="android.permission.FOREGROUND_SERVICE"
           tools:node="remove" />
   </manifest>

നിങ്ങൾ തുടർച്ചയായ ട്രാക്കിംഗ് * ഒപ്പം * ജിയോഫെൻസിംഗ് ഉപയോഗിക്കുകയാണെങ്കിൽ

ട്രാക്കിംഗ് ഉപയോഗത്തിനായി നിങ്ങൾക്ക് FOREGROUND_SERVICE_LOCATION സൂക്ഷിക്കാം (ഉദാ. നാവിഗേഷൻ/ഫ്ലീറ്റ് ട്രാക്കിംഗ്), എന്നാൽ ഫോർഗ്രൗണ്ട് സേവനം ഇതിനായി ഉപയോഗിക്കരുത് ജിയോഫെൻസിംഗ്. Tracelet ഇതിനകം ഇത് കൈകാര്യം ചെയ്യുന്നു: തുടർച്ചയായ ട്രാക്കിംഗിനായി FGS പ്രവർത്തിക്കുന്നു (start()), കൂടാതെ ജിയോഫെൻസ്-മാത്രം മോഡിലേക്ക് മാറുന്നു (നിലവാരത്തിൽ startGeofences() മോഡ്) FGS കീറുന്നു.

6. GPS ഡ്രിഫ്റ്റും തെറ്റായ EXIT ഇവൻ്റുകളും (ഉയർന്ന കൃത്യത മോഡ്)

ഉയർന്ന കൃത്യതയുള്ള മോഡിൽ, എല്ലാ GPS ഫിക്സിൽ നിന്നും ആപ്പിൽ പരിവർത്തനങ്ങൾ വിലയിരുത്തപ്പെടുന്നു. എ ഒരു ചെറിയ ജിയോഫെൻസിനുള്ളിൽ നിശ്ചലമായി നിൽക്കുന്ന ഉപകരണത്തിന് ഇടയ്ക്കിടെ a സ്വീകരിക്കാം ദൂരത്തിന് പുറത്ത് നന്നായി ഒഴുകുന്ന ഒറ്റ ഫിക്സ് - അത് ഒരിക്കലും നീങ്ങിയില്ലെങ്കിലും. ലേക്ക് ഒരു തെറ്റായ എക്സിറ്റ് വെടിവയ്ക്കുന്നതിൽ നിന്ന് തടയുക, ട്രേസ്ലെറ്റിൻ്റെ എക്സിറ്റ് തീരുമാനം കൃത്യത-അവബോധം: ഒരു വൃത്താകൃതിയിലുള്ള ജിയോഫെൻസ് മുഴുവൻ ജിപിഎസ് പിശക് ഒരിക്കൽ മാത്രം പുറത്തുകടക്കുന്നു സർക്കിൾ വേലി മായ്‌ക്കുന്നു:

EXIT fires when:  distance - horizontalAccuracy > radius + buffer

ഒരു ഫിക്സ് 160 മീറ്റർ പുറത്ത് റിപ്പോർട്ട് ചെയ്തു, എന്നാൽ ± 150 മീറ്റർ കൃത്യതയോടെ പരമാവധി “10 മീറ്റർ” മാത്രമാണ് ശുഭാപ്തിവിശ്വാസം ഉള്ളതിനാൽ, അത് ഇപ്പോഴും ഉള്ളിലാണെന്നും എക്‌സിറ്റ് ഫയർ ഇല്ലെന്നും കണക്കാക്കുന്നു. ഒരു ആത്മവിശ്വാസം, ഒരേ അകലത്തിൽ കൃത്യമായ ഫിക്സ് സാധാരണ പുറത്തുകടക്കുന്നു. ENTER മനഃപൂർവ്വം അവശേഷിക്കുന്നു കൃത്യത-അജ്ഞേയവാദം, അതിനാൽ വരവുകൾ ഇപ്പോഴും ഉടനടി ട്രിഗർ ചെയ്യുന്നു.

ഇടപാട്

ഫിക്സിൻറെ റിപ്പോർട്ട് ചെയ്ത കൃത്യതയ്ക്കൊപ്പം എക്സിറ്റ് ത്രെഷോൾഡ് വളരുന്നതിനാൽ, ഒരു യഥാർത്ഥ നിലവിലെ ജിപിഎസ് അനിശ്ചിതത്വം കാരണം പുറപ്പെടൽ വൈകുന്നു. 50 മീറ്റർ ജിയോഫെൻസിനായി (70 മീറ്റർ എക്സിറ്റ് ത്രെഷോൾഡ്):

നല്ല സിഗ്നലുള്ള ഔട്ട്ഡോർ ഇത് നിസ്സാരമാണ്. വിട്ടുമാറാത്ത മോശം-ജിപിഎസ് അവസ്ഥകൾ (ആഴമുള്ള വീടിനുള്ളിൽ, നഗര മലയിടുക്കുകൾ) ഒരു യഥാർത്ഥ എക്സിറ്റ് ശ്രദ്ധേയമായി വൈകും.

ഇത് ട്യൂൺ ചെയ്യുന്നു: geofenceExitAccuracyMax

നിങ്ങളുടെ ഉപയോഗ കേസ് വേഗതയേറിയതും കൂടുതൽ ഉത്സാഹമുള്ളതുമായ എക്സിറ്റ് തിരഞ്ഞെടുക്കുകയാണെങ്കിൽ - അല്ലെങ്കിൽ നിങ്ങൾ ബന്ധിപ്പിക്കാൻ ആഗ്രഹിക്കുന്നു ഏറ്റവും മോശമായ കാലതാമസം - GeofenceConfig.geofenceExitAccuracyMax (മീറ്ററിൽ):

await tl.Tracelet.ready(const tl.Config(
  geofence: tl.GeofenceConfig(
    geofenceModeHighAccuracy: true,
    // Absorb drift up to 20 m, but keep genuine exits reasonably prompt.
    geofenceExitAccuracyMax: 20,
  ),
));

സ്ഥിരീകരിച്ച എക്സിറ്റ്: ഒരു മോശം പരിഹാരം ഒരിക്കലും ഒരു എക്സിറ്റ് ട്രിഗർ ചെയ്യില്ല

ഒരു ഡ്രിഫ്റ്റിംഗ് ഫിക്സ് അതിൻ്റെ അനിശ്ചിതത്വത്തെക്കുറിച്ച് *സത്യസന്ധമായിരിക്കുമ്പോൾ മാത്രമേ കൃത്യത ഗേറ്റിംഗ് സഹായിക്കൂ (റിപ്പോർട്ട് ചെയ്ത വലിയ കൃത്യത). ചില ഉപകരണങ്ങൾ വിപരീതമാണ് ചെയ്യുന്നത്: അവ ഒരു പുറപ്പെടുവിക്കുന്നു അമിത ആത്മവിശ്വാസം വേലിക്ക് പുറത്ത് നൂറുകണക്കിന് മീറ്ററുകളോളം നിലംപതിക്കുന്നത് പരിഹരിക്കുക ഒരു ഇറുകിയ കൃത്യത റിപ്പോർട്ട് ചെയ്യുന്നു. കാരണം റിപ്പോർട്ട് ചെയ്ത കൃത്യത ചെറുതാണ്, ഗേറ്റിംഗ് അതിലൂടെ കാണാൻ കഴിയില്ല - 200 m − 1.7 m = 198 m ഇപ്പോഴും ത്രെഷോൾഡ് മായ്‌ക്കുന്നു.

രണ്ടാം, പരസ്പര പൂരകമായ പ്രതിരോധം ഉപയോഗിച്ച് ട്രേസ്ലെറ്റ് ഇവയെ പിടിക്കുന്നു: ഒരു EXIT ആയിരിക്കണം വേലിക്ക് പുറത്തുള്ള തുടർച്ചയായ രണ്ട് പരിഹാരങ്ങളിലൂടെ സ്ഥിരീകരിച്ചു. എന്നാണ് ന്യായവാദം ഭൌതിക - ജിയോഫെൻസ് വിടുന്നത് ഒരു സ്ഥിരമായ മാറ്റമാണ്, അതേസമയം അമിത ആത്മവിശ്വാസം തകരാർ എല്ലായ്‌പ്പോഴും ഒരൊറ്റ പരിഹാരമാണ്, അത് പുറത്തേക്ക് ചാടുകയും അടുത്തതിൽ തിരിച്ചെത്തുകയും ചെയ്യുന്നു ഒന്ന്:

fix 1: 200 m out  → held (pending confirmation), no EXIT
fix 2: back inside → pending cleared, glitch absorbed

ഒരു യഥാർത്ഥ പുറപ്പെടൽ പുറത്ത് നിൽക്കുന്നു, അതിനാൽ രണ്ടാമത്തെ ഫിക്സ് അത് കൃത്യമായി സ്ഥിരീകരിക്കുന്നു ഒരു എക്‌സിറ്റ് ഫയർ - ഒരു ലൊക്കേഷൻ അപ്‌ഡേറ്റ് കൊണ്ട് മാത്രം വൈകിയിരിക്കുന്നു (ഉയർന്ന കൃത്യതയിൽ ≈1 സെ മോഡ്). എക്സിറ്റ് തീരുമാനത്തിൻ്റെ സ്പേഷ്യൽ പകുതിയാണ് ഹിസ്റ്റെറിസിസ്, ഇതാണ്

• താൽക്കാലിക * പകുതി; രണ്ടും ഒരുമിച്ച് പ്രവർത്തിക്കുന്നു.

ഇത് സ്ഥിരസ്ഥിതിയായി ഓണാണ്, കോൺഫിഗറേഷൻ ആവശ്യമില്ല. തീരുമാനം റസ്റ്റിൽ ജീവിക്കുന്നു കോർ, അതിനാൽ Android-ഉം iOS-ഉം ഒരേപോലെ പ്രവർത്തിക്കുന്നു. (കൃത്യത ഗേറ്റിംഗ് പോലെ, ഇത് ബാധകമാണ് ഉയർന്ന കൃത്യതയുള്ള ഇൻ-ആപ്പ് പാതയിലേക്ക് മാത്രം - സ്റ്റാൻഡേർഡ് OS റീജിയൻ-മോണിറ്ററിംഗ് മോഡിൽ EXIT തീരുമാനം ഓപ്പറേറ്റിംഗ് സിസ്റ്റത്തിന് സ്വന്തമാണ്.)