تخطَّ إلى المحتوى
ɳSelf Docs

geolocation

هذا المحتوى غير متوفر بلغتك بعد.

Geolocation Plugin

Section titled “Geolocation Plugin”

Real-time location sharing, history tracking, and haversine geofencing with entry/exit events. Pro plugin.

Requires: Basic license tier or higher. nself license set nself_pro_...

Install

Section titled “Install”
Terminal window
nself license set nself_pro_xxxxx...
nself plugin install geolocation

What It Does

Section titled “What It Does”

The geolocation plugin enables real-time location sharing between users and records a configurable-retention history of position updates. Geofences trigger entry and exit events that downstream services can subscribe to, with haversine calculations used for accurate distance-based boundary checks.

Configuration

Section titled “Configuration”
Env VarDefaultDescription
GEOLOCATION_PORT3026Port the service listens on
GEOLOCATION_RETENTION_DAYS30Number of days to retain location history

Ports

Section titled “Ports”
PortPurpose
3026Geolocation REST API

Database Tables

Section titled “Database Tables”

5 tables added to your Postgres database:

  • np_geolocation_users
  • np_geolocation_locations
  • np_geolocation_history
  • np_geolocation_geofences
  • np_geolocation_events

Nginx Routes

Section titled “Nginx Routes”
RouteTarget
/api/geolocation/localhost:3026