Athenian Geotracking
product details.
Athenian Geotracking captures technician GPS updates and displays real-time field activity inside WordPress for Athenian Unya and connected service workflows. It helps teams connect mobile staff location, appointment coverage, dispatch visibility, and service accountability in one operational view while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian Geotracking is the live field-visibility layer for Athenian Unÿa and other Athenian service-platform deployments. It receives technician GPS and status updates through a WordPress REST API, stores each technician’s most recent operational location in a dedicated database table, and displays recent technician activity on a Google Maps-powered admin screen inside WordPress.
The plugin is designed for service businesses where dispatchers, coordinators, and operations teams need a current view of which technicians are active, where they are located, and when each person last checked in. Instead of coordinating technician status through calls, texts, screenshots, or disconnected fleet tools, Athenian Geotracking brings location awareness directly into the same WordPress admin environment used to manage service operations.
At its current stage, the plugin provides the core infrastructure for live technician visibility: REST ingestion, latest-location storage, admin settings, secured admin retrieval, and a live Technician Map inside the Athenian Unÿa admin area. It also establishes a foundation for future dispatch automation, nearest-technician recommendations, route intelligence, customer ETA tools, technician availability scoring, historical tracking, and mobile field-service integrations.
How Athenian Geotracking fits the Athenian Platform
Platform role: Athenian Geotracking is a focused capability in the Integrations, Channels & APIs and Service, Workforce & Learning Platforms layer. Its primary scope covers APIs, Webhooks & Automation and Scheduling, Booking & Field Service while remaining composable with the other modules an implementation actually requires.
Connected scope: Athenian Geotracking is designed to work inside a WordPress and WooCommerce operating environment where storefront, customer, order, identity, payment, fulfillment, automation, and reporting context can remain connected across relevant modules instead of being trapped in isolated add-ons.
From module to operating platform: Athenian Brands organizes the ecosystem in four connected layers: Platform Kernel and Platform Core foundations; focused capability plugins; implementation and integration services; and operating brands such as PrintGhost.ai, Athenian Marketplace, Athenian Academy, and Athenian Unÿa that apply the same patterns to real business workflows.
Field Visibility
Give Dispatchers a Live View of Technician Activity Inside WordPress
Athenian Geotracking adds a Google Maps-powered Technician Map where
operations teams can monitor recent technician locations, availability,
status, and last check-in activity from the WordPress admin.
| Visibility Layer | Operational Value |
|---|---|
| Technician Map | Display recent technician locations on a live Google Maps interface inside the Athenian Unÿa admin area. |
| Status Awareness | Show technician status values such as available, busy, or offline alongside each recent location record. |
| Recency Filtering | Focus the map on recently updated technicians so stale field data does not distract dispatch decisions. |
| Auto Refresh | Refresh technician markers automatically so dispatchers can keep the map open during active operations. |
- Adds the Technician Map under Athenian Unÿa > Technician Map.
- Uses the Google Maps JavaScript API for admin map rendering.
- Refreshes technician marker data every 15 seconds in the current admin JavaScript implementation.
- Displays missing-key guidance when the Google Maps API key has not been configured.
Location Infrastructure
Receive Technician GPS Updates and Store Current Field State
The plugin exposes a REST endpoint for technician location updates and stores
each technician’s latest known latitude, longitude, heading, speed, status,
and timestamp in a dedicated geotracking database table.
Accept technician GPS and status updates from mobile apps or field clients
Persist latest technician state in a dedicated custom table
Return recent technician rows to the secured admin map endpoint
| Technical Layer | How It Helps |
|---|---|
| Update Endpoint | Receives technician location updates through POST /wp-json/athenian-geo/v1/technician-location. |
| Recent Technicians | Returns recent location records through GET /wp-json/athenian-geo/v1/technicians with recency and status filters. |
| Custom Table | Stores operational location state in wp_ath_geo_locations instead of overloading post meta. |
| Technician Identity | Resolves technician IDs against WordPress posts, aligning naturally with Unÿa-style technician records. |
- Stores fields for
technician_id,lat,lng,heading,speed,status, andupdated_at. - Supports default admin filters such as
minutes_recentandstatus. - Creates the geotracking table on plugin activation using WordPress database tooling.
- Uses the
ath_geo_google_maps_api_keyoption for Google Maps configuration.
Dispatch Intelligence
Build the Location-Awareness Backbone for Service Operations
Athenian Geotracking provides the platform-native location layer that can
support smarter dispatch, nearest-technician suggestions, route awareness,
customer ETA tools, mobile dashboards, and technician availability logic.
| Platform Layer | Operational Purpose |
|---|---|
| Unÿa Alignment | Pairs naturally with Athenian Unÿa technician records, booking workflows, service assignments, and dispatch operations. |
| Mobile Client Ready | Provides a simple REST contract that technician apps, browser dashboards, or companion services can post into. |
| Dispatch Expansion | Creates a foundation for nearest-technician lookup, distance-to-job calculations, assignment recommendations, and service-area overlays. |
| Production Hardening | Identifies clear next steps for authenticated technician updates, per-technician authorization, token validation, rate limiting, and coordinate validation. |
Field visibility inside the service platform:
Athenian Geotracking helps teams answer who is active, where they are,
and how recently they checked in without leaving the WordPress and Unÿa
operations environment.
- Restricts the admin technician retrieval endpoint to users with
manage_options. - Notes that the current location update endpoint uses a development-mode open permission callback and should be hardened before production use.
- Builds toward customer ETA windows, arrival notifications, masked customer-facing location previews, and technician en-route messaging.
- Supports future reporting ideas such as route playback, time-in-field metrics, service-area heatmaps, and missed check-in detection.