Real-time location sharing, location history, geofence entry/exit events, and proximity queries. Clients push coordinates; the plugin stores history, evaluates geofences, and fires webhooks on boundary crossings. Privacy-first: all location data stays in your own Postgres database.
Set your license key with nself license set nself_pro_... before installing.
nself license set nself_pro_...
nself plugin install geolocation
nself build
nself startcurl -X POST http://127.0.0.1:3026/geolocation/update \
-H "Content-Type: application/json" \
-d '{
"user_id": "usr_abc123",
"lat": 37.7749,
"lng": -122.4194,
"accuracy_meters": 10,
"timestamp": "2026-06-01T12:00:00Z"
}'curl "http://127.0.0.1:3026/geolocation/nearby?lat=37.7749&lng=-122.4194&radius_meters=1000"| Endpoint | Method | Description |
|---|---|---|
/geolocation/update | POST | Push a location update for a user |
/geolocation/current/:user_id | GET | Get the most recent location for a user |
/geolocation/history/:user_id | GET | Get location history with time range filter |
/geolocation/nearby | GET | Find users within a radius of given coordinates |
/geolocation/distance | GET | Calculate distance between two users or points |
/health | GET | Plugin health check |
nself plugin remove geolocationPort: 3026 | Category: Geo | Last Updated: April 2026 | Plugin Version 1.1.1